Провайдеры

Провайдер — это одна вышестоящая конечная точка LLM плюс способ подключения к ней: адаптер, базовый URL, режим аутентификации и необязательный список моделей. Провайдеры находятся в ~/.opencodex/config.json в секции providers.

Режимы аккаунтов OpenAI

Id провайдера	Назначение	Правило учётных данных/аккаунтов
`openai`	Вход Codex	Pool (по умолчанию) выбирает основной и добавленные аккаунты; Direct использует только текущий вход вызывающей стороны/основной вход.
`openai-apikey`	OpenAI API	Только настроенный API-ключ/пул ключей; аккаунты Codex никогда не читаются.

Используйте «голый» gpt-5.6-sol с опцией Pool/Direct на странице Providers или openai-apikey/gpt-5.6-sol для API. Между маршрутами учётных данных нет сквозного фолбэка. Маршрут API публикует метаданные: контекст 922,000 / максимум входных токенов 922,000. Его виртуальные id sol-pro, terra-pro и luna-pro сохраняют выбранную публичную идентичность, тогда как в фактическом запросе используется базовая модель плюс reasoning.mode: "pro".

Если встроенный провайдер openai отсутствует или отключён, его можно восстановить из выбора Accounts на панели и со страницы Codex Auth: отсутствующие записи создаются из канонического пресета, отключённые канонические записи включаются без замены сохранённого режима и настроек моделей, а неканонические записи openai этот путь восстановления не получают.

Ёмкость пула в обзоре провайдеров

Для входа Codex в режиме Pool обзор Providers показывает оценку использованной ёмкости всего пула, а не показатель произвольного аккаунта. В той же строке отображается исходный процент квоты текущего активного аккаунта, поэтому оценку пула можно отличить от состояния аккаунта, который будет использован для следующего запроса.

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

Предупреждение о частичном покрытии окон означает, что некоторые включённые аккаунты сообщили данные только для части показанных окон квоты. Обзор сохраняет окна раздельными, отмечает каждое затронутое окно как неполное и не считает отсутствующее значение использованием в этом окне.

Эта оценка предназначена только для отображения. Она не меняет выбор аккаунта, привязку сессии, автоматическое переключение, cooldown или другие решения маршрутизации. Состояние отдельных аккаунтов и настройки маршрутизации описаны в разделе пула аккаунтов Codex Auth.

Поставляемые v1-конфигурации автоматически мигрируют на маркер 2 и одну строку с поддержкой опций. Исходная конфигурация один раз сохраняется в ~/.opencodex/config.json.pre-openai-tiers-v2.bak; восстановить её можно командой cp ~/.opencodex/config.json.pre-openai-tiers-v2.bak ~/.opencodex/config.json.

Режимы аутентификации

Конфигурация провайдера принимает три значения authMode (по умолчанию — key). Встроенный реестр также отдельно помечает локальные пресеты; в них обычно нет ни authMode, ни apiKey.

`authMode`	Как выполняется аутентификация	Кем используется
`key`	Отправляет ваш API-ключ (`Authorization: Bearer …` либо `x-api-key` / `api-key` в зависимости от адаптера). Ключ может быть литералом или ссылкой вида `${ENV_VAR}`.	Большинство провайдеров.
`forward`	Передаёт провайдеру входящие заголовки аутентификации Codex без изменений — ключ не хранится. Это сквозной режим (passthrough) входа через ChatGPT.	OpenAI (адаптер `openai-responses`).
`oauth`	Берёт сохранённый OAuth-токен доступа (автоматически обновляется до истечения срока) и использует его как bearer-ключ.	xAI, Anthropic, Kimi, Kiro, Google Antigravity, Cursor, Command Code, GitHub Copilot, Nous Portal.

Повтор при 429 на том же ключе (retryOn429) применим только к провайдерам с API-ключом (authMode: "key"). Пресеты OAuth, forward и local исключены — их учётные данные нельзя повторно отправлять по тому же токену, а у локальных сред выполнения нет удалённого ключа. Это opt-in: при отсутствии опции функция выключена; наличие объекта включает её, если только enabled: false.

1. Вход через ChatGPT (forward / passthrough)

Провайдеру openai не нужен API-ключ. Direct пересылает учётные данные вашего существующего codex login; Pool сначала выбирает основной или добавленный аккаунт Codex, а затем использует тот же бэкенд:

{
  "openai": {
    "adapter": "openai-responses",
    "baseUrl": "https://chatgpt.com/backend-api/codex",
    "authMode": "forward"
  }
}

Пересылается только ограниченный набор заголовков (FORWARD_HEADERS: authorization, ChatGPT account id, OpenAI beta/originator/session — см. Адаптеры). Этот же путь обеспечивает работу сайдкаров веб-поиска и vision.

Каталог сквозного режима ChatGPT дополнительно включает «голые» слаги GPT-5.6 Sol/Terra/Luna (gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna) для аккаунтов, которым они доступны.

2. Вход по аккаунту (OAuth)

Пресеты провайдеров могут использовать вход по аккаунту — в том числе GitHub Copilot через экспериментальный неофициальный мост device flow. opencodex хранит их учётные данные в ~/.opencodex/auth.json и обновляет их автоматически. CLI входа принимает и ocx login codex, но это не один из провайдеров выше: команда направляется во вход пула аккаунтов Codex (тот же поток, что и ocx account login codex). У пула отдельный реестр аккаунтов, поэтому такому входу нужен запущенный прокси. chatgpt и openai — псевдонимы того же маршрута.

ocx login xai          # xAI Grok
ocx login anthropic    # Anthropic Claude (Pro/Max)
ocx login kimi         # Moonshot Kimi
ocx login nous         # Nous Portal (device grant; модели free + paid)
ocx login kiro         # импорт учётных данных kiro-cli (с фолбэком на токен)
ocx login google-antigravity
ocx login cursor       # отдельный PKCE-вход Cursor
ocx login command-code # браузерный OAuth Command Code (или импорт ~/.commandcode/auth.json)
ocx login devin       # Cognition/Devin: сначала импорт данных Devin CLI, иначе вход через браузер Auth0
ocx login dsh-account # DeepSeek Harness Desktop (импорт разрешения ~/.dsh/.credentials.yaml)
ocx login github-copilot  # device flow GitHub → токен Copilot (Copilot Pro/Business)
ocx login codex        # пул аккаунтов Codex (псевдонимы: chatgpt, openai; нужен запущенный прокси)
ocx logout <provider>

Провайдер	Адаптер	Базовый URL	Примечания
`xai`	`openai-chat`	`https://cli-chat-proxy.grok.com/v1`	OAuth использует отдельный шлюз подписки Grok CLI. Переопределение с API-ключом использует `https://api.x.ai/v1` и может добавлять Priority Processing. Каталог Grok загружается в реальном времени; фолбэк по умолчанию — `grok-4.5`.
`anthropic`	`anthropic`	`https://api.anthropic.com`	Модели Claude; актуальный список моделей загружается из `/v1/models`.
`kimi`	`openai-chat`	`https://api.kimi.com/coding/v1`	Модели Kimi Code. Алиас `kimi-for-coding` теперь указывает на K2.8 Preview: контекст до 1 млн токенов, уровни рассуждения `low`/`high`/`max`, текстовый и графический ввод. У `k3-256k` фиксированный предел 256K.
`kimi-responses`	`openai-responses`	`https://api.kimi.com/coding/v1`	Использует тот же вход OAuth и список моделей, что и `kimi`, но через протокол Responses. Содержимое рассуждений остаётся зашифрованным на сервере; вызовы инструментов и их результаты видны.
`nous`	`openai-chat`	`https://inference-api.nousresearch.com/v1`	Шлюз подписки Nous Research (тот же бэкенд, что использует Hermes Agent). Вход по device grant против `portal.nousresearch.com`; access-токен — это JWT для каждого запроса к inference. Смешанный каталог платных + `:free` моделей (`tencent/hy3:free`, `stepfun/step-3.7-flash:free`, …) обнаруживается вживую по авторизованному аккаунту. Refresh-токены одноразовые и ротируются при каждом обновлении.
`kiro`	`kiro`	`https://runtime.us-east-1.kiro.dev`	Первый вход импортирует существующую сессию после установки Kiro CLI (в Unix: `curl -fsSL https://cli.kiro.dev/install` \| `bash`; в Windows PowerShell: `irm 'https://cli.kiro.dev/install.ps1'` \| `iex`; затем выполните `kiro-cli login`). Добавить аккаунт выполняет выход из `kiro-cli`, запускает новый вход через браузер, переключает аккаунт самого `kiro-cli` и сохраняет метаданные профиля отдельно для каждого аккаунта. Существующие аккаунты OpenCodex сохраняются; при отмене или сбое восстанавливается предыдущая сессия `kiro-cli`.
`google-antigravity`	`google`	`https://daily-cloudcode-pa.googleapis.com`	Google OAuth поверх протокола Cloud Code Assist. Живое обнаружение использует аутентифицированный CCA-эндпоинт `v1internal:fetchAvailableModels` и публикует только agent-модели, доступные текущему аккаунту; поддерживаемый каталог остаётся резервным вариантом.
`cursor`	`cursor`	`https://api2.cursor.sh`	Экспериментальный PKCE-вход, живой транспорт HTTP/2 и обнаружение моделей с фильтрацией по аккаунту.
`devin`	`devin`	`https://server.codeium.com`	Экспериментальный неофициальный мост к Cognition/Devin. Вход сначала импортирует учётные данные, которые уже хранит установленный Devin CLI (`devin auth login` записывает `devin-session-token` в его `credentials.toml`); если их нет — открывает страницу Auth0 в браузере и обменивает вставленный токен через `RegisterUser` на долгоживущий API-ключ. `ocx login devin-cli` продолжает работать как устаревший алиас. Список моделей запрашивается для каждой учётной записи через `GetCascadeModelConfigs`; потоковая передача идёт только по пути `runTurn` поверх Connect-RPC. В пресете панели по умолчанию отсутствует.
`dsh-account`	`dsh-account`	`https://api.deepseek.com/anthropic`	Экспериментальный провайдер с приоритетом импорта, повторно использующий аккаунт установленного и авторизованного DeepSeek Harness (DSH) Desktop. Считывает учётные данные строго в режиме только для чтения из `~/.dsh/.credentials.yaml` при явном импорте. Полностью независим от тарификации API-ключей DeepSeek.
`github-copilot`	`openai-chat`	`https://api.githubcopilot.com`	Экспериментально. Device flow GitHub + обмен `copilot_internal` (OAuth-клиент VS Code). Требуется активная подписка Copilot; это не официальный сторонний API.

Проверки квот аккаунтов и провайдера Google Antigravity используют фиксированные адреса Google, включая резервный запрос списка моделей. Для этих адресов поддерживается прозрачный Fake-IP DNS с сохранением проверки TLS, запрета перенаправлений и проверки частных адресов. Пользовательский base URL меняет только запросы моделей; NO_PROXY сохраняет политику прямого подключения.

Диагностика потерь схем инструментов Google

Объявления инструментов Google компилируются для выбранного класса конечной точки. Когда отладка провайдера включена командой ocx debug provider on, переключателем Logs в дашборде или переменной OCX_DEBUG=1, потеря схемы при преобразовании совместимости на пути с отсутствующей политикой или compatible записывает событие [ocx:google:google-tool-schema-loss] (следите за ним через ocx debug provider logs -f). Оно содержит только версию отчёта, класс конечной точки, индикатор lossy, ограниченный счётчик неопределённых сравнений, фиксированные категории потерь с ограниченными счётчиками и признак усечения. Имена инструментов и свойств, пути, значения и текст схемы не включаются. При отсутствии политики или compatible преобразование только наблюдается. При reject-lossy начальная компиляция с потерей или неопределённым результатом ограниченного сравнения отклоняется до отправки; отдельное событие потери для отклонённого запроса не записывается. При reject-lossy восстановление Vertex или Cloud Code Assist, снимающее ограничения, пишет столь же безопасное событие google-tool-schema-repair и возвращает исходный 400 без изменённой отправки; при отсутствии политики или при compatible исправленный запрос повторяется как прежде. Прямой AI Studio такое восстановление не выполняет. Нативные схемы вывода исключены из обоих путей. См. справочник команд отладки.

После терминального сбоя обновления Nous выполните ocx login nous, чтобы пройти повторную аутентификацию.

Для канонических пресетов Kimi Coding Plan (вход через аккаунт kimi и API-ключ kimi-code) opencodex передаёт в запрос Chat Completions только стабильный prompt_cache_key, предоставленный вызывающей стороной, и никогда не создаёт его сам. Документация Kimi требует стабильный ключ сессии/задачи для повышения доли попаданий в кэш Code Plan; запрос без ключа остаётся без ключа. Если включённый провайдер отклоняет поле, opencodex не удаляет его для повторной попытки и не изменяет сохранённую конфигурацию. Для остальных провайдеров действует deny-by-default.

Стоимость k3, k3[1m] и k3-256k для kimi, kimi-code и kimi-responses — оценка по тарифам API с ценой записи в кэш по умолчанию на пять минут. Она не отражает оплату или квоты Code Plan: версия K3 с контекстом 1M расходует примерно вдвое больше квоты, чем k3-256k. Алиас kimi-for-coding теперь ведёт на K2.8 Preview, поэтому прежняя цена K2.7 больше не используется. Без заданного пользователем modelCosts оценка остаётся неизвестной, и правила маршрутизации, исключающие неизвестную стоимость, могут отклонить алиас.

OAuth можно запустить и из веб-дашборда.

Несколько OAuth-аккаунтов

OAuth-провайдеры, чьи учётные данные содержат стабильный id аккаунта или email, могут хранить несколько входов. Страница Providers показывает эти аккаунты в выпадающем списке, позволяет добавить ещё один и переключает активный аккаунт, не выполняя выход из остальных. При обычном входе учётные данные Kimi без идентификатора заменяют активный слот; явное действие Добавить аккаунт сохраняет прежний слот и активирует отдельный новый. Аккаунты Kiro сохраняются по ARN профиля. chatgpt всегда занимает один слот, поскольку у пула аккаунтов Codex отдельный реестр. Токены остаются в ~/.opencodex/auth.json; /api/oauth/accounts возвращает только маскированные метаданные.

Импорт Cockpit Tools Antigravity

В v1 OpenCodex импортирует только JSON-экспорт Cockpit Tools Antigravity для провайдера google-antigravity. На вкладке «Аккаунты» этого провайдера в панели Providers выберите локальный JSON-файл. Панель не показывает содержимое файла или значения учётных данных: она выводит только числа импортированных, обновлённых, ошибочных и неподдерживаемых записей. Другие провайдеры Cockpit в v1 не поддерживаются.

CLI принимает экспорт только из файла или stdin — не вставляйте его в аргумент команды:

ocx account import google-antigravity --format cockpit-tools --file <path> [--json]
cat accounts.json | ocx account import google-antigravity --format cockpit-tools --stdin [--json]

Inline JSON и лишние позиционные аргументы отклоняются. Храните экспортированные файлы приватно и удаляйте их или защищайте после импорта.

Импорт учётных данных Kiro

Для входа Kiro требуется Kiro CLI: в Unix установите его командой curl -fsSL https://cli.kiro.dev/install | bash, в Windows PowerShell — irm 'https://cli.kiro.dev/install.ps1' | iex, затем сначала выполните kiro-cli login. Если сессии kiro-cli нет, ocx login kiro использует вставленный токен доступа или переменную окружения KIRO_ACCESS_TOKEN.

Обычный импорт ocx login kiro открывает базу SQLite CLI только для чтения и не изменяет базу, WAL или SHM.

KIROCLI_DB_PATH выбирает нестандартную базу SQLite Kiro CLI; указанная база должна уже существовать.
KIROCLI_TOKEN_KEY выбирает точный ключ строки auth_kv, если найдено несколько неоднозначных строк с токенами. Без выбора вход завершается ошибкой, а не пытается угадать строку.

Импортированные учётные данные сохраняются в ~/.opencodex/auth.json. Откат Добавить аккаунт — отдельная операция: при восстановлении предыдущего снимка она заменяет базу и удаляет текущие sidecar-файлы WAL, SHM и journal.

Поскольку откат возможен только при наличии снимка, Добавить аккаунт откажется выходить из kiro-cli, если хранилище сессии существует, но его нельзя захватить (файл не читается, несовпадение схемы, неоднозначный выбор токена), если KIROCLI_DB_PATH / KIRO_CLI_DB_FILE направляют импорт не на активное хранилище CLI, или если в основной базе CLI нет распознаваемой строки токена. Исправьте или удалите повреждённую базу по обычному пути данных kiro-cli, снимите селекторы только для импорта и повторите попытку. На машины без существующей сессии kiro-cli это не влияет.

DeepSeek Account (DSH)

dsh-account — экспериментальный провайдер учётных записей с приоритетом импорта, предназначенный для повторного использования аутентифицированных учётных данных установленного приложения DeepSeek Harness (DSH) Desktop.

Независимость от API-ключа DeepSeek: dsh-account использует квоту авторизованной сессии DeepSeek пользователя (баланс обычного/бонусного кошельков и общие расходы), тогда как провайдер deepseek списывает средства с баланса API-ключа платформы. Эти два домена учётных данных и маршрутизации строго разделены и никогда не переключаются друг на друга.
Только явный импорт: OpenCodeX определяет наличие установленного и авторизованного DeepSeek Harness (~/.dsh/.credentials.yaml), но никогда не копирует, не импортирует и не использует токен автоматически без явного действия пользователя (ocx login dsh-account или нажатия кнопки «Импорт» в веб-дашборде).
Хранилище учётных данных DSH только для чтения: OpenCodeX обращается с ~/.dsh/.credentials.yaml исключительно в режиме только для чтения. OpenCodeX никогда не записывает, не изменяет, не удаляет файлы и не меняет права доступа к файлам DeepSeek Harness.
Изолированная копия учётных данных и выход: При импорте OpenCodeX проверяет токен через официальный эндпоинт идентификации DeepSeek (/auth-api/v0/users/current) и сохраняет собственную копию в хранилище аутентификации OpenCodeX. Выход из системы или удаление аккаунта в OpenCodeX удаляет только локальную копию OpenCodeX; это никогда не вызывает завершение удалённой сессии и не приводит к выходу из DeepSeek Harness Desktop.
Без фонового обновления токена и повторный импорт при 401: Разрешения сессий DSH не поддерживают эндпоинт автоматического фонового обновления. Если апстрим возвращает HTTP 401 (ACCOUNT_TOKEN_INVALID), OpenCodeX помечает аккаунт как needsReauth и прекращает маршрутизацию. Для восстановления доступа пользователь должен выполнить явный повторный импорт через ocx login dsh-account.
Отказ от ответственности третьих сторон: OpenCodeX не заявляет об официальном одобрении или авторизации со стороны DeepSeek для сторонних клиентов, повторно использующих сессионные разрешения.

3. Каталог API-ключей

opencodex поставляется с 104 встроенными пресетами: 84 на основе ключей, 16 OAuth, три локальных и один пресет ChatGPT-форварда по умолчанию. Селектор Add provider в дашборде открывает страницу выдачи ключей провайдера, проверяет ключ и сохраняет его; проверка зависит от провайдера. Наиболее заметные записи:

ClinePass подключается с помощью Cline API key к официальному каталогу подписки и Chat Completions endpoint. Оператор — Cline Bot Inc., указанный в условиях Cline. Маршрут вида cline-pass/cline-pass/kimi-k3 намеренный: первая часть выбирает провайдера opencodex, а полный slug cline-pass/kimi-k3 отправляется upstream. Использование учитывается в общих для аккаунта скользящем 5-часовом, недельном и месячном лимитах. Проверка живого API 2026-08-13 подтвердила, что все статические модели ClinePass принимают на входе шлюза low, medium, high, xhigh и max. opencodex сохраняет запрошенный tier без изменения; нормализация для конкретного backend остаётся ответственностью ClinePass.

Cline использует тот же ключ и эндпоинт с оплатой по мере использования и доступом к 100+ моделям (ID в формате OpenRouter, например anthropic/claude-sonnet-4-6). Промо-бесплатные модели Cline доступны только в IDE/CLI Cline, а не через API; minimax/minimax-m2.5 документирован как бесплатная модель для экспериментов через API.

Провайдер	Базовый URL
OpenAI (API key)	`https://api.openai.com/v1`
Anthropic (API key)	`https://api.anthropic.com`
OpenRouter	`https://openrouter.ai/api/v1`
Cline	`https://api.cline.bot/api/v1`
ClinePass	`https://api.cline.bot/api/v1`
Ollama Cloud	`https://ollama.com/v1`
Google Gemini · Google Vertex AI	`https://generativelanguage.googleapis.com` · `https://aiplatform.googleapis.com`
Azure OpenAI	`https://{resource}.openai.azure.com/openai`
Umans AI · Neuralwatt	`https://api.code.umans.ai` · `https://api.neuralwatt.com/v1`
Mistral	`https://api.mistral.ai/v1`
MiniMax · MiniMax (CN)	`https://api.minimax.io/v1` · `https://api.minimaxi.com/v1`
DeepSeek	`https://api.deepseek.com`
Cerebras	`https://api.cerebras.ai/v1`
Chutes	`https://llm.chutes.ai/v1`
DeepInfra	`https://api.deepinfra.com/v1/openai`
Hyperbolic	`https://api.hyperbolic.xyz/v1`
Nscale Serverless Inference	`https://inference.api.nscale.com/v1`
Vultr Serverless Inference	`https://api.vultrinference.com/v1`
Baseten Model APIs	`https://inference.baseten.co/v1`
Command Code	`https://api.commandcode.ai/provider/v1`
SambaNova Cloud	`https://api.sambanova.ai/v1`
Nebius Token Factory	`https://api.tokenfactory.nebius.com/v1`
Crusoe	`https://api.inference.crusoecloud.com/v1`
DigitalOcean Serverless Inference	`https://inference.do-ai.run/v1`
Scaleway Generative APIs	`https://api.scaleway.ai/v1`
Featherless AI	`https://api.featherless.ai/v1`
Novita AI	`https://api.novita.ai/openai/v1`
Together	`https://api.together.xyz/v1`
Fireworks	`https://api.fireworks.ai/inference/v1`
Moonshot (Kimi API) · Kimi (coding)	`https://api.moonshot.ai/v1` · `https://api.kimi.com/coding/v1`
Hugging Face	`https://router.huggingface.co/v1`
NVIDIA NIM	`https://integrate.api.nvidia.com/v1`
Z.AI (GLM Coding)	`https://api.z.ai/api/coding/paas/v4`
Zhipu AI (BigModel)	`https://open.bigmodel.cn/api/paas/v4`
BigModel Coding Plan — Responses (статический список)	`https://open.bigmodel.cn/api/v1`
Qwen Cloud	Token plan (по умолчанию): `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` · Pay as you go: `https://dashscope.aliyuncs.com/compatible-mode/v1` · или Custom
Tencent Cloud Coding Plan	`https://api.lkeap.cloud.tencent.com/coding/v3`
SiliconFlow	`https://api.siliconflow.cn/v1`
Volcengine Ark · Coding Plan · Agent Plan	`https://ark.cn-beijing.volces.com/api/v3` · `https://ark.cn-beijing.volces.com/api/coding/v3` · `https://ark.cn-beijing.volces.com/api/plan/v3`
Xiaomi MiMo	`https://api.xiaomimimo.com/anthropic`
Xiaomi MiMo (OpenAI Chat)	`https://api.xiaomimimo.com/v1`
Kilo	`https://api.kilo.ai/api/gateway`
OpenGateway	`https://apis.opengateway.ai/v1`
GitLab Duo	`https://cloud.gitlab.com/ai/v1/proxy/openai/v1`
Cloudflare AI Gateway	`https://gateway.ai.cloudflare.com/v1/{account-id}/{gateway}/anthropic`
…и другие	opencode zen, Vercel AI Gateway, Venice, NanoGPT, Synthetic, Qianfan, Alibaba, Parallel, ZenMux, LiteLLM

OpenGateway — OpenAI-совместимый шлюз компании Sionic AI по адресу https://apis.opengateway.ai/v1. Публичный каталог содержит около 80 активных моделей (проверено 2026-10-02). Пресет автоматически обновляет список через публичный GET /v1/models, оставляя активные модели Chat Completions (а также openai/o3-pro, доступную только через Responses и направляемую в Responses). Модели, обслуживаемые Sionic, deepseek/deepseek-v4.1-flash-ultrafast и z-ai/glm-5.3-flash-ultrafast, показаны первыми. Создайте ключ в панели OpenGateway, затем выполните ocx provider add opengateway или выберите OpenGateway в панели. Chat-запросы используют настроенный Bearer-ключ; публичный список не подтверждает действительность ключа.

OpenCode Zen (opencode-zen) использует https://opencode.ai/zen/v1 с API-ключом из opencode.ai/auth. Бесплатные модели могут упираться в короткий лимит около 15–20 запросов в минуту (оценка сообщества; OpenCode не публикует RPM). Если ответ 429 о лимите частоты не содержит Retry-After, opencodex добавляет пояснение и синтетический Retry-After; корректные заголовки сервера имеют приоритет. Повторы с тем же ключом включаются через retryOn429.

На официальных маршрутах https://opencode.ai/zen/v1 и https://opencode.ai/inference/v1 канонического провайдера opencode-zen с аутентификацией API-ключом Gemini автоматически использует нативный API Google в стандартном режиме googleMode: ai-studio. Идентификаторы моделей Zen сохраняются, включая Flash без суффикса -tiered. Claude использует Anthropic Messages независимо от googleMode. При загрузке сохранённой конфигурации игнорируются только допустимые старые переопределения Chat/Responses для этих нативных моделей и допустимые настройки размещённого инструмента image_generation, предназначенные только для Responses. Пользовательские провайдеры, маршруты без аутентификации ключом и остальные настройки не меняются.

Поддержка opencode-free удалена: теперь все модели возвращают 403 permission_denied из-за ограничения бесплатного уровня OpenCode (#7255). При загрузке существующей конфигурации соответствующие записи и ссылки на модели отключаются в памяти, предупреждение выводится один раз на процесс, файл не изменяется. Если это был провайдер по умолчанию, используется стандартный маршрут OpenAI OAuth. Выберите opencode-go, opencode-zen с ключом или другого провайдера. Условия OpenCode Zen.

Рабочие назначения и значения по умолчанию Claude Desktop сохраняются. Правила с опустевшим списком разрешённых исходных моделей отключаются; при удалении модели внедрения отключается и синхронизация нативных субагентов. Последующие сохранения не восстанавливают удалённые ссылки и сохраняют корректные параллельные изменения.

Большинство провайдеров использует адаптер openai-chat с bearer-ключом; пресеты с поддержкой протокола Anthropic, такие как Xiaomi MiMo (xiaomi), используют адаптер anthropic (x-api-key). У Xiaomi также есть пресет OpenAI Chat xiaomi-mimo и пресет токенного плана mimo. Все три по умолчанию используют MiMo V2.6 (mimo-v2.6-pro, а xiaomi-mimo — mimo-v2.6-flash). 2026-10-21 Xiaomi прекратит поддержку mimo-v2.5 и mimo-v2.5-pro без перенаправления. До этой даты смените сохранённую модель V2.5 по умолчанию: opencodex не изменит её автоматически. Volcengine Coding Plan и Agent Plan используют нативные конечные точки Responses через адаптер openai-responses. В проверенных продолжениях с вызовом инструментов на Ark Coding Plan повторная отправка элемента reasoning, возвращённого предыдущим ходом, даёт 400 InvalidParameter, поэтому пресет Coding Plan удаляет такие элементы перед пересылкой входа продолжения. Состояние reasoning того хода при этом теряется; отключается через dropResponsesReasoningItems: false. Уже сохранённая конфигурация Coding Plan с openai-chat не переписывается и остаётся на Chat: чтобы перейти, вручную смените adapter на openai-responses и responsesPath на /responses либо удалите и заново добавьте пресет.

Три маршрута тарификации Volcengine: volcengine — Ark API с оплатой по факту, volcengine-coding-plan расходует квоту Coding Plan, а volcengine-agent-plan — квоту Agent Plan. Используйте ключ и конечную точку одного продукта; обычный /api/v3 может тарифицироваться отдельно даже при активной подписке Plan. Все три preset используют отобранные статические каталоги моделей. Ark /models возвращает текстовые, embedding-, графические, видео- и 3D-ресурсы, а шлюз Coding выдаёт тот же широкий каталог. У шлюза Agent Plan ресурса /models нет. Для pay-as-you-go модель по умолчанию — doubao-seed-2-1-pro-260628; его статический каталог также включает актуальные текстовые модели DeepSeek и GLM. Для Coding Plan модель по умолчанию — ark-code-latest, для Agent Plan — deepseek-v4-flash.

Discovery для Chutes. Пресет chutes использует фиксированный общий OpenAI-совместимый LLM gateway Chutes. Из публичного каталога /v1/models он оставляет только строки, где supported_features содержит tools, сохраняет нативные id со знаком / и безопасные live metadata, а также ограничивает discovery размером 256 KiB и 128 исходными строками. Публичный каталог не может подтвердить корректность введённого ключа, но chat-запросы всё равно аутентифицируются настроенным Bearer-ключом. Пользовательские Chute host и API не для LLM требуют custom provider. Ключ создаётся в дашборде Chutes.

Discovery для DeepInfra. deepinfra — провайдер OpenAI Chat Completions с аутентификацией по ключу; он использует адаптер openai-chat и Bearer API-ключ. Принадлежащий registry URL списка моделей DeepInfra оставляет только строки с тегом chat, сохраняет нативные id моделей со знаком / и ограничивает live discovery 512 KiB и 512 исходными строками. Ключи создаются в дашборде DeepInfra.

Discovery для Hyperbolic. Пресет читает /v1/models с настроенным bearer-ключом, сохраняет нативные id моделей со знаком / и ограничивает live discovery размером 256 KiB и 256 исходными строками. Он охватывает только serverless text и vision-language chat; отдельные image, audio и GPU endpoint в него не входят. Ключи создаются в Hyperbolic.

Discovery для Nscale и Vultr. Оба пресета читают аутентифицированный каталог /v1/models, сохраняют нативные id и ограничивают discovery размером 256 KiB и 256 исходными строками. Каталог Nscale смешивает chat-, image- и embedding-модели без поля modality, поэтому пресет допускает только meta-llama/Llama-3.1-8B-Instruct — модель из официального примера API с вызовом инструментов. Vultr сейчас документирует tool calling только для kimi-k2-instruct, поэтому его пресет показывает только эту модель. Остальные строки скрыты до появления равноценного подтверждения agent-tool. Service token Nscale создаётся в Nscale Console, а inference key Vultr копируется со страницы подписки в Vultr Console.

Discovery для Command Code. Пресет читает список /provider/v1/models с фиксированного хоста Provider API, сохраняет исходные идентификаторы моделей и ограничивает размер каталога 256 KiB и 256 исходными строками. ocx login command-code поддерживает вход через OAuth в браузере и может импортировать локальные учётные данные CLI из ~/.commandcode/auth.json для пользователей Command Code CLI. После входа каталог моделей загружается через аутентифицированную конечную точку discovery и зависит от учётной записи. Пресет Provider API (commandcode) отправляет активный настроенный ключ: для большинства моделей используется Chat Completions с заголовком Bearer, а модели claude-* идут через Anthropic Messages с x-api-key, поскольку Command Code предоставляет их только по адресу /provider/v1/messages. Если другой провайдер использует имя commandcode для иной конечной точки, он сохраняет собственный протокол. Пресет OAuth (command-code) использует сохранённый bearer-токен учётной записи для аутентифицированного discovery и передаёт поток генерации из /alpha/generate в формате NDJSON. Разметка вызова инструментов MiMo, которую шлюз возвращает как текст, удаляется, если она дублирует настоящий вызов. Для моделей MiMo полный вызов объявленного инструмента без соответствующего нативного вызова восстанавливается только после штатного завершения; при прерывании или фильтрации ответа разметка остаётся текстом. Ключи Provider API создаются в Command Code Studio.

Квота Command Code. Дашборд и ocx account refresh опрашивают окна /alpha/billing/credits (5 часов и неделя) на каноническом хосте https://api.commandcode.ai. OAuth-пресет (command-code) использует сохранённый bearer аккаунта; пресет Provider-API ключа (commandcode) — активный настроенный ключ. Пользовательски изменённый похожий base URL не опрашивается. Если Command Code также сообщает расход за период, оставшиеся monthly / purchased / free credits показываются как USD-окно.

При входе в OrcaRouter через браузер (ocx login orcarouter-oauth) тело успешного ответа при обмене кода на ключ должно быть корректным JSON в UTF-8 размером не более 64 KiB. Действующий 30-секундный лимит этого запроса охватывает получение заголовков и всего тела ответа; слишком большое или некорректное тело отклоняется до сохранения ключа. Эти ограничения относятся только к обмену кода на ключ при входе, а не к содержимому запросов инференса. Проверка scope не меняется: отсутствие поля допускается, а явно недопустимое значение отклоняется.

Discovery для SambaNova Cloud. Пресет читает общедоступный список SambaNova Cloud /v1/models на фиксированном API-хосте, сохраняет нативные id провайдера и ограничивает discovery размером 128 KiB и 128 исходными строками. Каталог не требует аутентификации, поэтому процедура входа CLI сообщает, что ключ невозможно проверить, вместо того чтобы считать публичный ответ подтверждением его действительности. Chat-запросы по-прежнему используют настроенный Bearer-ключ; параллельные вызовы функций отключены, поскольку SambaNova пока их не поддерживает. Частные endpoint развёртываний SambaStudio не входят в область пресета. Ключи создаются в SambaNova Cloud.

Discovery для Nebius Token Factory. Пресет запрашивает аутентифицированный verbose-каталог и оставляет только модели, architecture которых выдаёт текст, исключая embedding и image-generation. Он сохраняет нативные id со знаком /, а также заявленные context и input-modality metadata, и ограничивает discovery размером 512 KiB и 512 исходными строками. Хосты dedicated deployment не входят в область пресета. Ключи создаются в Nebius Token Factory.

Discovery для Crusoe. Пресет с ключом использует adapter openai-chat и отправляет Bearer key только на фиксированный host Serverless Inference Crusoe. /v1/models отвечает 401 на запросы без ключа, поэтому успешный список считается проверкой ключа. Discovery сохраняет нативные id с косой чертой, такие как zai-org/GLM-5.3 и moonshotai/Kimi-K2.6, ровно в том виде, в каком их возвращает Crusoe, и ограничен 256 KiB и 256 исходными строками. Остаются только строки с is_public: true и architecture.modality text или multimodal, так что приватные для аккаунта развёртывания, а также embedding- и медиа-строки исключаются. Reasoning-модели возвращают рассуждения в поле reasoning Chat Completions, которое adapter читает. Лестницу reasoning_effort (low, medium, high) принимает только openai/gpt-oss-120b; остальные reasoning-модели трактуют это поле как переключатель вкл/выкл, поэтому пресет не заявляет ни provider-wide лестницу effort, ни provider-wide parallel tool calls. Лимиты действуют на project и model (429 при превышении, 503 пока общий deployment масштабируется); новые аккаунты получают $5 бесплатных кредитов. Ключ создаётся в консоли Crusoe Cloud в разделе Intelligence Foundry, Inference.

Discovery для DigitalOcean. Пресет использует model access key на фиксированном общем хосте Serverless Inference и публикует только пересечение аутентифицированного ответа /v1/models с подтверждённым документацией allowlist для Chat Completions. Неизвестные, Responses-only, embedding- и media-generation id исключаются по принципу fail closed. Discovery ограничен 256 KiB и 256 исходными строками; agent-specific и dedicated хосты не входят в область пресета. Ключи создаются в DigitalOcean Control Panel.

Discovery для Scaleway. Пресет публикует пересечение аутентифицированного списка моделей с подтверждённым документацией allowlist Serverless Chat Completions. Неизвестные, Responses-only, embedding-, transcription- и прочие media-model id исключаются по принципу fail closed; discovery ограничен 128 KiB и 128 исходными строками. Используется общий endpoint Project по умолчанию; URL с Project ID и dedicated deployment настраиваются как custom provider. API-ключ создаётся в консоли Scaleway.

Discovery для Featherless. Пресет проходит аутентификацию на фиксированном OpenAI-совместимом хосте и запрашивает только первые 100 популярных моделей, отфильтрованных по chat и текущему plan. Затем registry по принципу fail closed требует, чтобы каждая строка отдельно подтверждала доступность по plan, отсутствие Hugging Face gate и features.tool_use: true. Discovery ограничен 128 KiB и 100 исходными строками, поэтому каталог из десятков тысяч моделей не загружается и не кэшируется целиком. /v1/models описан как вызываемый как с аутентификацией, так и без неё, поэтому не может подтвердить корректность введённого ключа, но chat-запросы всё равно аутентифицируются настроенным Bearer-ключом. Индивидуальные plan предназначены для interactive/prototype; произвольные приложения требуют Scale plan. Ключ создаётся в дашборде Featherless.

Discovery для Novita. Пресет с ключом использует adapter openai-chat и отправляет Bearer key только на фиксированный OpenAI-совместимый host Novita. Из публичного списка моделей остаются лишь строки, одновременно указывающие model_type: chat и endpoint chat/completions; discovery ограничен 512 KiB и 256 исходными строками. Поскольку catalog публичный, login сообщает, что ключ невозможно проверить, а не считает успешный список доказательством. Возможности зависят от модели, поэтому пресет не заявляет provider-wide parallel tool calls или OpenAI reasoning_effort. Ключ создаётся в Novita key manager.

Область Baseten: пресет поддерживает только общие Model APIs Baseten. Для локальной работы используйте личный API-ключ, а для общего/промышленного использования — командный ключ с правом Call Model APIs. Выделенные конечные точки Truss predict используют другие хосты и схемы и этим пресетом не маршрутизируются. Для этого пресета live discovery ограничен ответом размером 1 MiB и 256 исходными строками моделей.

Квота кредитов A6API

Пользовательский провайдер с openai-chat, authMode: "key" и каноническим адресом https://api.a6api.com или https://api.a6api.com/v1 показывает расход кредитов A6API в дашборде и в ocx account refresh <provider>. Имя провайдера может быть любым. Единицы токенов пересчитываются в USD по hard credit limit учётной записи; отображаются процент расхода и остаток. Срок действия токена не считается сбросом квоты, поскольку он не означает пополнение. Только активный ключ отправляется на канонический хост, перенаправления отклоняются, а отрицательные или несогласованные итоги биллинга не создают отчёт.

Ограничение Tencent Cloud Coding Plan: Tencent разрешает использовать эту подписку только в интерактивных инструментах программирования. Автоматизация общего API, серверы пользовательских приложений и неинтерактивные пакетные вызовы запрещены и могут привести к блокировке ключа плана.

Тарификация GLM: zai — это международная подписка Z.AI на coding-план, а zhipu-bigmodel — внутренняя китайская конечная точка BigModel с оплатой по факту использования. Разные хосты, разные ключи, разная тарификация: ключ от одного сервиса не подойдёт к другому.

Несколько API-ключей

Провайдеры на основе ключей тоже могут хранить несколько ключей. Ключ, добавленный через страницу Providers, сохраняется в provider.apiKeyPool, становится активным и дублируется в provider.apiKey, чтобы маршрутизация и адаптеры по-прежнему читали то же поле, что и раньше. В том же выпадающем списке можно переключать и удалять ключи; API управления — /api/providers/keys, он возвращает только маскированные ключи.

Переключение аккаунтов из терминала

Используйте ocx account list, ocx account current и ocx account use, чтобы просматривать и переключать те же пулы Codex, OAuth и API-ключей, не открывая дашборд. Команды, JSON-вывод и поведение в новых сессиях описаны в разделе Справочник CLI.

Превью-маршруты GPT-5.6

GPT-5.6 Sol/Terra/Luna заранее внесены в резервные списки провайдеров, чтобы ocx sync сохранял модели видимыми, даже когда живые каталоги отстают:

Маршрут Codex	Предзаданные id моделей	Контекст, видимый Codex
Вход Codex (Pool или Direct)	`gpt-5.6-*`	922,000
OpenAI (API key)	`openai-apikey/gpt-5.6-` плюс `-pro`	922,000 (макс. вход 922,000)
OpenRouter	`openrouter/openai/gpt-5.6-sol`, `openrouter/openai/gpt-5.6-terra`, `openrouter/openai/gpt-5.6-luna`	922,000
Cursor	`cursor/gpt-5.6-sol`, `cursor/gpt-5.6-terra`, `cursor/gpt-5.6-luna`	1,000,000

Нативные записи GPT-5.6 сохраняют закреплённые вышестоящие шкалы уровней рассуждений (например, у Luna есть max, но нет ultra). Маршрутизируемые записи используют метаданные и сопоставления уровней рассуждений своего провайдера. Доступность всех четырёх маршрутов по-прежнему определяется вышестоящей стороной; живое обнаружение Cursor дополнительно отфильтровывает статический предзаданный список до моделей, доступных вошедшему аккаунту.

Провайдер попадает в список, когда у opencodex есть подходящий wire-адаптер, а не в зависимости от того, является ли он «агентским» продуктом. Текущие id адаптеров: openai-chat, openai-responses, anthropic, google (режимы AI Studio, Vertex и Antigravity/Cloud Code Assist), azure / azure-openai, kiro и cursor. Проприетарный API без одной из этих реализаций — например, нативный Amazon Bedrock — напрямую не поддерживается. GitHub Copilot — это OAuth-провайдер (ocx login github-copilot), который обменивает вход через device flow GitHub на короткоживущий API-токен Copilot, а не принимает вставленный API-ключ. GitLab Duo остаётся шлюзом с ключом/токеном подписки на своей OpenAI-совместимой конечной точке. Cloudflare AI Gateway требует подставить в URL id аккаунта и шлюза.

Copilot предоставляет каталог со смешанными проводами: модели (gpt-5.3-codex, gpt-5.4, gpt-5.4-mini, gpt-5.5, gpt-5.6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-6-astra, grok-4.5, grok-4.6, mai-code-1.1-flash, mai-code-1-flash-picker) отклоняют /chat/completions для агентного трафика, поэтому opencodex по умолчанию маршрутизирует эти модели через Responses API, а все остальные модели Copilot остаются на chat completions. Приоритет: жёсткий wire-пин → явная запись modelAdapters → дефолт реестра → adapter всего провайдера. Чтобы перевести модель без встроенного дефолта (например, gpt-5.4-nano) на Responses, задайте "modelAdapters": { "gpt-5.4-nano": "openai-responses" }.

Cursor отслеживается отдельно как экспериментальный адаптер. adapter: "cursor" появляется в ocx init и в селекторе Add Provider дашборда как экспериментальная запись локальной конфигурации с метаданными статического резервного каталога моделей Cursor. Когда настроен токен доступа Cursor, opencodex использует живой транспорт HTTP/2 Cursor. Его встроенный резервный список включает gpt-5.6-sol / terra / luna (контекст 1M), обычные/Fast-строки Grok 4.5, 4.6 и 4.7 (500K) и kimi-k3 (262K); живое обнаружение решает, какие из них останутся видимыми для аккаунта. Для Grok 4.6 и 4.7 в обеих формах доступны low / medium / high / xhigh, а для 4.5 — только до high. Для Grok 4.5 и 4.6 Fast-запросы передают соответствующую базовую модель с отдельными параметрами effort и fast=true в requested_model; их плоские id cursor-grok-{version}-{effort}-fast служат только идентификаторами discovery и picker. Grok 4.7 отображается без префикса cursor- и напрямую передаёт grok-4.7-{effort}-fast. Cursor отдаёт Kimi K3 только через wire id с суффиксом усилия, поэтому cursor/kimi-k3 предоставляет лестницу low / high / max и по умолчанию использует max — как и задокументированное значение по умолчанию в API модели. Управляемое сервером Cursor нативное выполнение read/write/delete/ls/grep/shell/fetch по умолчанию отключено, поскольку оно обходит путь одобрений и песочницу Codex; устанавливайте unsafeAllowNativeLocalExec: true в объекте providers.cursor файла ~/.opencodex/config.json только для доверенных локальных экспериментов (или через Providers → Cursor → Edit JSON в дашборде). Полный пример см. в справочнике по конфигурации. MCP, запись экрана и computer-use доступны как хуки исполнителя; без настроенного локального исполнителя opencodex возвращает типизированные результаты «нет исполнителя», а не блокирует запрос политикой. Для этого экспериментального адаптера включены Cursor OAuth и живое обнаружение моделей; при этом Cursor по-прежнему не показывается в списках входа по ключу.

Ollama Cloud

Ollama Cloud — это размещённая в облаке (не локальная) Ollama. Укажите адрес https://ollama.com/v1 и ключ со страницы ollama.com/settings/keys. opencodex обращается к ней через собственный REST API Ollama (POST /api/chat), а не через OpenAI-совместимую поверхность, и получает список моделей от провайдера, поэтому новые модели Ollama Cloud появляются без изменения конфигурации. opencodex классифицирует её облачную линейку по поддержке изображений, чтобы vision-сайдкар включался только для текстовых моделей. Текстовые модели (например, glm-5.2, deepseek-v4-flash, gpt-oss, qwen3-coder, minimax-m2.x, nemotron-3-*) перечислены в noVisionModels; модели с нативной поддержкой изображений (например, kimi-k2.6, minimax-m3, gemma4, qwen3.5, gemini-3-flash-preview) — нет. Сопоставление терпимо к тегам Ollama вида :size, поэтому gpt-oss покрывает и gpt-oss:120b, и gpt-oss:20b.

Ollama в документации указывает, что структурированный вывод сейчас не поддерживается на Ollama Cloud. Поэтому для канонического ollama-cloud opencodex отклоняет такие запросы (text.format) явной ошибкой, а не молча возвращает свободную прозу; локальные и пользовательские ollama-native конечные точки сохраняют нативное поведение format Ollama.

4. Локальные провайдеры

Направьте opencodex на локальный OpenAI-совместимый сервер — обычно с пустым ключом:

Провайдер	Базовый URL
Ollama (local)	`http://localhost:11434/v1`
vLLM	`http://localhost:8000/v1`
LM Studio	`http://localhost:1234/v1`

Любая OpenAI-совместимая конечная точка

Если провайдер поддерживает Chat Completions, с ним справится адаптер openai-chat — выберите Custom в дашборде или custom в ocx init и введите базовый URL. Все поля провайдера (headers, noReasoningModels, noVisionModels, models, …) описаны в справочнике по конфигурации.