Сторонние эндпоинты · сверено 2026-09-22

Сторонние эндпоинты и ключи в Orca — у каждого агента

В документации сказано: Orca запускает любой CLI-агент, работающий в терминале, а список лишь поднимает процесс, поэтому эндпоинт и ключ вписываются в настройки, которые читает сам агент. Здесь 11 строк: где поле описано, копируем название, где нет (сторонний эндпоинт Cursor CLI) — так и помечаем. Агенты протокола Anthropic меняют переменную окружения эндпоинта, OpenAI-совместимые задают base_url, ключ и id модели, и ловушки у них в разных местах (сверено 2026-09-22).

Обновлено 2026-09-22

#11 агентов в таблице#дословно из документации#BYOK: свой ключ и эндпоинт#Anthropic и OpenAI-совместимый

Что разбирает эта таблица: 4 пункта

10 / 11

Строки с дословной цитатой

11 CLI-агентов разложены по строкам: каждая повторяет только путь к настройке и имена параметров из официальной документации этого агента, со ссылкой на источник. По состоянию на 2026-09-22 в 10 строках есть дословные фразы про собственный эндпоинт или свой ключ, а по строке Cursor CLI документация молчит. Каждый агент живёт в своей строке, и за вендоров ничего не додумывают.

2 семейства эндпоинтов

Anthropic Messages против OpenAI-совместимых

Первое семейство — Anthropic Messages: в Claude Code адрес ставится в ANTHROPIC_BASE_URL, чтобы вести запросы через прокси или шлюз, а ключ — в ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY по ожидаемому заголовку. Там же сказано, что Anthropic не аудирует сторонние шлюзы и не поддерживает маршрутизацию Claude Code на не-Claude модели. Второе семейство — OpenAI-совместимое: base_url, ключ и model id прописываются в настройке самого агента. Проверено 2026-09-22.

3 переключателя в Orca

Выбор агента, аргументы в Settings, worker-start

Ни один из 3 переключателей не меняет адрес эндпоинта за вас. Встроенный выбор агента просто запускает преднастроенный CLI в терминале, глубокая интеграция помечена отдельно по каждому агенту. В Settings можно переопределить аргументы запуска и переменные окружения одного агента — после этого Orca его не трогает. У orca orchestration worker-start флаг --model описан только для этих 3, а оркестрацию сначала включают в Settings → Experimental. Флаги меняются вместе с приложением, поэтому запись верна по состоянию на 2026-09-22.

1 строка из 11

Cursor CLI: сторонние эндпоинты не описаны

Cursor CLI официально описывает 2 способа входа: браузерный вход или пользовательский API-ключ из панели Cursor через CURSOR_API_KEY. В документации, проверенной 2026-09-22, из сетевых пунктов только прокси и HTTP/1.1, общего base_url нет; свой ключ описан только для AWS Bedrock, который официально идёт через ваш аккаунт AWS вместо модельных провайдеров Cursor. Поэтому в строке «не описано», а не «не поддерживается».

Перед таблицей: 3 слоя

Слой эндпоинта: каждый CLI-агент читает только свой конфиг. В семействе Anthropic адрес меняют переменными окружения, в OpenAI-совместимом семействе base URL, ключ и model id вписывают в конфиг или панель настроек самого агента, названия полей берут из документации вендора. Слой учётных данных: ключ выдаёт провайдер модели или шлюз, и кладут его туда, куда указывают официальные документы: в имя переменной окружения, в поле конфига или в строку ввода панели. Слой оркестрации: про встроенный выборчик в документации Orca буквально сказано “the agent combobox just launches a process in a terminal”, а своим вкладом Orca называет worktree, панели терминала, обзор изменений и управление сессиями. Поэтому «подставить сторонний ключ в Orca» — это править конфиг 11 агентов по отдельности. Поля и источники сверены 2026-09-22.

Почему у таблицы стоит дата

На момент сверки 2026-09-22 перевод агента на сторонний эндпоинт — штатная функция документации, а не форумный трюк. Страница BYOK у Droid начинается с Use your own OpenAI or Anthropic keys. Qwen Code прямо называет OpenRouter и Requesty в разделе про OpenAI-совместимость. OpenCode пишет, что baseURL задаётся для любого provider, приводя в пример прокси и собственные эндпоинты. Схема конфига Codex определяет base_url как адрес OpenAI-совместимого API этого provider. Гид Grok CLI по собственным моделям начинается с альтернативных provider и self-hosted моделей. Движение идёт и обратно: страница sunset у Roo Code говорит, что все продукты остановлены 2026-05-15, так что та строка официальна, но уже исторична. Темп обновлений разный (OpenCode печатает дату обновления 2026-09-21, Roo Code — 2026-05-15), поэтому эта страница несёт только свою дату сверки 2026-09-22.

Хронология проверок

2026-05-15

Дату и состав остановки Roo Code здесь не пишем: официальную фразу не удалось взять дословно, на сайте это не проверялось (проверено 2026-09-22). Строка повторяет официальную формулировку, но читается как история.

2026-09-21

2026-09-21: дата последнего обновления в подвале официальной страницы OpenCode про провайдеров; там же описано, что baseURL любого провайдера можно направить на прокси или свой эндпоинт. Страница не перенимает даты из подвалов вендоров, а несёт только свою дату проверки.

2026-09-22

2026-09-22: каждую строку сверяли заново с официальной документацией 11 агентов и Orca; пути и имена полей переписаны так, как их пишут вендоры, у каждой строки есть источник, а Cursor CLI помечен как «не описано», а не «не поддерживается». Сам Orca говорит, что флаги меняются с версиями, поэтому таблица верна только на эту дату.

Что в документации есть и чего нет

Сказано дословно

В 10 строках из 11 формулировки воспроизведены слово в слово из документов самого агента: Claude Code - ANTHROPIC_BASE_URL плюс ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY; Codex - base_url и env_key в секции model_providers; OpenCode и Kilo Code - options.baseURL, каждая страница описывает своё; Cline и Roo Code - API Provider, Base URL, API Key и Model в панели настроек (путь к файлу не указан); Qwen Code - baseUrl и envKey в modelProviders внутри settings.json; Kimi Code - base_url в ветке openai; Droid - customModels в ~/.factory/settings.json с model, baseUrl, apiKey; Grok CLI - base_url и env_key в ~/.grok/config.toml. Orca добавляет ещё 3 официальные фразы: выборчик лишь запускает процесс в терминале, аргументы и окружение отдельного агента переопределяются в Settings, а --model описан для Claude, Codex и Cursor. Сверено 2026-09-22.

3 вещи, о которых таблица молчит

Пункт 1: строка Cursor CLI говорит «в документации нет», а не «документация запрещает». Сканирование 15 её CLI-страниц 2026-09-22 даёт 0 совпадений по base_url, baseUrl, OPENAI_BASE_URL и ANTHROPIC_BASE_URL, показывает лишь 4 переменных CURSOR_; страница аутентификации знает только вход через браузер и пользовательский ключ из кабинета Cursor, единственный путь с собственными ключами — AWS Bedrock. Пункт 2: «поддерживает свой эндпоинт» не значит «любой эндпоинт заработает». Сам Droid пишет we cannot guarantee that all custom models will work out of the box, а Anthropic указывает, что не одобряет, не сопровождает и не проверяет сторонние шлюзы и не поддерживает маршрутизацию Claude Code на не-Claude модели. Пункт 3: строки не одинаково свежи: Roo Code называет дату остановки продуктов 2026-05-15, а OpenCode печатает 2026-09-21. Эта страница описывает соответствие только на 2026-09-22.

2 способа задать эндпоинт: общее и различия

Что общего у 2 стилей

2 стиля делают одно: агент перестаёт слать инференс-запросы на первый хост вендора. Правки всегда в конфиге самого агента, и нужны те же 3 элемента: эндпоинт, ключ, model id. На стороне Orca различий тоже нет: по документации встроенный выборчик просто запускает процесс в терминале, аргументы запуска и окружение отдельного агента переопределяются в Settings, и уже переопределённого агента Orca не трогает. Сверено 2026-09-22.

Различия 2 стилей и подвохи

Подвохи лежат в разных местах. Claude Code, ветка Anthropic Messages, правит переменные окружения или блок env файла settings.json; в документации сказано, что при конфликте с shell-экспортом действует значение из файла, что на не-первом хосте MCP tool search по умолчанию выключен и что Remote Control отключается, когда хост не api.anthropic.com. Anthropic также не одобряет, не сопровождает и не проверяет сторонние шлюзы, а эндпоинт обязан отдавать /v1/messages и пропускать anthropic-beta и anthropic-version без изменений. В OpenAI-совместимой ветке подвох в написании: base_url у Codex и Kimi Code, options.baseURL у OpenCode и Kilo Code, baseUrl у Qwen Code и Droid; ключ где-то вводят значением (панели Cline и Roo Code), а где-то только именем переменной (env_key у Codex, envKey у Qwen Code, env_key у Grok CLI). Сверено 2026-09-22.

3 шага: выбрать семью, вписать, проверить

Шаг 1 — семья. Anthropic Messages настраивается переменными: Claude Code пишет эндпоинт в ANTHROPIC_BASE_URL, чьё официальное определение — пропускать запросы через прокси или шлюз. Остальные здесь OpenAI-совместимые: base_url, ключ и model id лежат в конфиге самого агента. Шаг 2 — куда писать по документации. В файл: блок env в settings.json у Claude Code либо секция model_providers с произвольным именем в ~/.codex/config.toml. В панель: Cline и Roo Code говорят выбрать OpenAI Compatible как API Provider, затем заполнить Base URL, API Key, Model. Шаг 3 — один минимальный запрос. В Orca, в настройках, агенту переопределяют аргументы запуска и переменные окружения; переопределённого агента Orca не трогает. Если у него есть своя проверка, берите её: у Grok после правки ~/.grok/config.toml советуют grok inspect (сверено 2026-09-22).

Откуда именно входит ключ

Orca не проксирует модели и не хранит ваши учётные данные: на официальной first-session странице сказано, что она запускает CLI агента в верном рабочем каталоге и передаёт учётные данные вашей подписки. Значит и эндпоинт, и ключ меняются в конфиге самого запускаемого CLI — и этот ключ может быть от QCode; на этом мост ограничивается. Мы не пишем, что Orca поддерживает QCode, и не пишем, что достаточно подключить: Anthropic о шлюзах пишет, что не рекомендует, не поддерживает и не проверяет их и не поддерживает маршрутизацию Claude Code к не-Claude моделям, а в примерах у него LiteLLM, Kong и внутренние прокси — нас там нет. Если повернуть это семейство не на первый хост, меняются 2 задокументированных поведения; они, как и те 2 переменные, — на /anthropic-base-url-setup-guide. Расход по ключу на стороне агрегатора — на /api-key-usage-query-guide (сверено 2026-09-22).

Частые вопросы

Можно ли на одной машине дать нескольким агентам разные ключи?

Да, потому что общий конфиг у них и не был. На официальной странице supported сказано: выпадающий список агентов просто запускает процесс в терминале, поэтому эндпоинт и учётка относятся к тому CLI, который подняли. Claude Code читает блок env в settings.json и те 2 переменные, Codex — ~/.codex/config.toml, Droid — записи customModels в ~/.factory/settings.json, Qwen Code — ~/.qwen/settings.json, а Cline и Roo Code — то, что введено в их панелях настроек. Для Claude Code есть официальное правило: переменная-учётка шлюза важнее сохранённого входа claude.ai или ключа Console, то есть свой ключ перекрывает подписку. Cursor CLI — обратный пример: в документации только вход через браузер и API key, и ключ этот выдаёт сам Cursor. Сверено 2026-09-22.

Почему полоса использования Orca не показывает мой шлюз?

Потому что он не спрашивает вендора. На официальной странице usage-tracking стоит Orca reads the local usage state each agent maintains on disk, и сразу за этим No API calls, no extra auth.; там же сказано, что числа обновляются, когда агент сам записывает, а не в реальном времени. Покрытие, названное на той странице, — 6 агентов: Claude Code, Codex, Gemini, OpenCode, Kimi Code, MiniMax. Корректно ли это чтение после того, как ты повернул эндпоинт к стороннему шлюзу, в официальной документации не написано, и мы за неё не додумываем. Счёт по агрегатору смотри у того, кто выдал ключ (сверено 2026-09-22).

Почему --model действует не для всех агентов?

Потому что в документации он есть только у 3 агентов. Страница orchestration пишет --model accepts opaque provider model IDs for Claude, Codex, and Cursor. и в том же предложении требует, чтобы --effort шёл вместе с --model и применялся лишь когда этот агент и модель поддерживают уровень. Сами эти команды требуют сначала включить Settings → Experimental. У остальных агентов эндпоинт и модель меняются в их собственном конфиге — для того и нужна таблица из 11 строк на этой странице. Orca сам пишет Command flags evolve with the app, так что всё это верно только на дату сверки, 2026-09-22.

Перезапишет ли обновление Orca мою настройку эндпоинта?

Разделяем на два. Orca в документации обязуется только за аргументы запуска и окружение: при новом запуске у каждого поддерживаемого CLI предзаполнен флаг пропуска разрешений, а если ты переопределил конкретного агента, официальная фраза — Orca leaves that agent alone, и дальше правило: непустое кастомное значение считается явным переопределением, и агент выводится из будущих миграций режима разрешений. Перезапишет ли какое-то обновление твои конфиги агентов — так не написано, и общего «никогда не тронем» тоже нет; цитировать можно только эти фразы. Реально дрейфуют имена полей и пути у вендоров: эндпоинт лежит в твоём пользовательском файле, а обновление Orca и обновление того CLI — разные события (сверено 2026-09-22).

Как найти ошибку в эндпоинте?

Начнём с формы base_url: в документации Qwen сказано, что для самостоятельно поднятого OpenAI-совместимого шлюза в baseUrl пишут корень /v1, например https://gateway.example.com/v1, а не весь путь /v1/chat/completions — SDK дописывает путь сам. Дальше проверяем семью: формат Anthropic Messages у Claude Code требует, чтобы эндпоинт пропускал без изменений заголовки anthropic-beta и anthropic-version. Затем — прочитался ли конфиг: у Grok после правки ~/.grok/config.toml предлагают запускать grok inspect и смотреть, что найдено. В конец — куда вставили учётку: правило Claude Code — ANTHROPIC_AUTH_TOKEN если про bearer token или Authorization header и ANTHROPIC_API_KEY если про API key или x-api-key; если переменная задана и в shell, и в блоке env файла settings.json, приоритет у файла (сверено 2026-09-22).

В каком файле физически лежат эти ключи?

У всех по-разному, и это делится на файлы и панели настроек. Claude Code: официальный путь — блок env в settings.json, плюс прямое предупреждение не класть учётку в .claude/settings.json внутри проекта, потому что этот файл коммитится и уходит всем, кто клонировал репозиторий. Codex: в схеме env_key хранит имя переменной окружения, а не сам ключ, а поле для значения напрямую помечено как нежелательное по соображениям безопасности. Kilo: ссылки на переменные окружения раскрываются только в доверенных местах, проектный файл из репозитория их не раскрывает, и итог в документации — Keep provider credentials in your global config. OpenCode: /connect пишет учётку в ~/.local/share/opencode/auth.json. Cline и Roo Code: поле API Key в панели настроек. У Grok есть фраза Prefer env_key over hardcoding api_key. Сам Orca ничего из этого не хранит — он только запускает тот CLI (сверено 2026-09-22).

Источники

Orca: agents/supported, agents/usage-tracking, cli/orchestration и first-session в https://raw.githubusercontent.com/stablyai/orca/main/docs/site/content/docs/, в отображаемом виде на https://www.onorca.dev/docs. Агенты: code.claude.com/docs/en/env-vars плюс llm-gateway, llm-gateway-connect и llm-gateway-protocol; raw.githubusercontent.com/openai/codex/main/codex-rs/core/config.schema.json; opencode.ai/docs/providers/; docs.cline.bot/provider-config/openai-compatible; docs.roocode.com/providers/openai-compatible и её sunset; kilo.ai/docs/code-with-ai/agents/custom-models; github.com/QwenLM/qwen-code/blob/main/docs/users/configuration/auth.md; docs.factory.ai/model-independence/byok.md; cursor.com/docs/cli/reference/authentication; docs.x.ai/build/overview и build/settings/reference. Всё сверено 2026-09-22; если страница датирована раньше, цитируем её содержимое на тот день.

Сначала эндпоинт, потом параллельно

Эта страница отвечает на одно: для каждого из 11 CLI-агентов в той таблице — где официальные документы ставят сторонний эндпоинт и как называются поля. Orca не поставляет моделей — он запускает агентов, на которых у тебя уже подписка, и запускаемый CLI читает твой собственный конфиг, так что ключ может быть от QCode. Обещаний по совместимости какого-либо шлюза мы не даём; формулировки сверены 2026-09-22.

Похожие материалы

Эта страница пересказывает открытую документацию Orca и каждого CLI-вендора из той таблицы; мы не связаны со Stably, Orca и вендорами и не имеем от них одобрения. Пути файлов, имена полей и формы команд ограничены официальными страницами, снятыми 2026-09-22; вендоры правят документы, а Orca сам пишет, что флаги его команд меняются вместе с приложением. Страница sunset у Roo Code говорит, что 2026-05-15 все её продукты остановлены, так что эта строка читается как история. QCode — лишь один возможный поставщик ключа в том конфиге: про совместимость сторонних шлюзов мы не судим и за поведение Orca или любого CLI-агента не отвечаем.