BYOK · настройка и тарифы

GitHub Copilot BYOK: свой ключ для Claude, GPT и китайских моделей

На 2026-10-07 документация QCode описывает два места, где GitHub Copilot может работать с Claude по вашему API-ключу (BYOK): Custom Endpoint в VS Code Chat (apiType messages) и Copilot CLI (COPILOT_PROVIDER_TYPE=anthropic). Пользовательский эндпоинт в JetBrains официально описан только как OpenAI-совместимый, поэтому через QCode там подтверждены лишь GPT и китайские модели. По документации VS Code, для BYOK-моделей тариф Copilot не нужен; встроенные подсказки через BYOK не идут.

Обновлено 2026-10-08

#VS Code Custom Endpoint#Copilot CLI BYOK#Anthropic Messages#OpenAI-совместимый эндпоинт

Четыре ключевых значения

messages

apiType для Claude в VS Code

Custom Endpoint в VS Code поддерживает три API: Chat Completions, Responses и Anthropic Messages. В документации QCode прямо сказано, что модели Claude работают только с messages.

anthropic

Тип провайдера для Claude в Copilot CLI

COPILOT_PROVIDER_TYPE официально принимает только openai (по умолчанию), azure или anthropic. Для Claude ставьте anthropic, для GPT и китайских моделей openai.

Полный путь / корень

Две формы URL противоположны

В VS Code url пишется до пути запроса, например https://api.qcode.cc/api/v1/messages; в CLI переменная COPILOT_PROVIDER_BASE_URL содержит только https://api.qcode.cc/api. Документация QCode предупреждает: формы противоположны, и перенос одной в другую гарантированно ломает запрос.

Не нужен

Тариф Copilot для BYOK в VS Code

По документации VS Code, BYOK-модели работают без входа в GitHub и без тарифа Copilot; администраторы Copilot Business и Enterprise могут отключить это политикой.

Что такое Copilot BYOK и где он работает

На 2026-10-07 Copilot BYOK означает, что вы вводите в клиенте Copilot адрес своего провайдера моделей и API-ключ, и запросы чата и агента уходят на настроенный вами эндпоинт, а не к моделям, размещённым у GitHub. Документация GitHub различает два вида. Локальный BYOK обрабатывает ключи только на стороне клиента и хранит их локально; его поддерживают VS Code, JetBrains, Xcode, Copilot CLI, GitHub Copilot app и Copilot SDK. Корпоративный BYOK: владельцы предприятия или организации добавляют ключи централизованно для пользователей Copilot Business и Enterprise, сейчас это публичная предварительная версия. По словам GitHub, локальный BYOK не зависит от Copilot API, поэтому подходит для изолированных сетей и пользователей без подписки Copilot. Он касается только чата: документация VS Code указывает, что встроенным подсказкам (автодополнению кода) и семантическому поиску по-прежнему нужен аккаунт GitHub.

Почему сейчас ищут BYOK

За месяц с небольшим GitHub трижды объявил о снятии встроенных моделей Copilot. Согласно changelog GitHub, 2026-09-01 в большинстве сред Copilot были сняты Claude Opus 4.5, Opus 4.6, Sonnet 4.5, Sonnet 4.6 и другие (Sonnet 4.6 остаётся у индивидуальных подписчиков с годовым планом); 2026-10-02 из всех сред Copilot ушли Claude Opus 4.7 и ещё три модели; 2026-10-19 планируется снять ещё шесть: GPT-5.5, GPT-5.4, GPT-5.4 mini, GPT-5 mini, Gemini 3.7 Flash и Grok 4.5. С BYOK модель вы задаёте сами в конфигурации (список models в VS Code, COPILOT_MODEL в CLI). В примечаниях к выпуску Copilot CLI также сказано, что при неверной конфигурации CLI выдаёт понятную ошибку и никогда молча не переключается на модели GitHub.

Как BYOK появился в разных частях Copilot

2026-04-07

Copilot CLI получает BYOK и локальные модели: несколько переменных окружения перед запуском позволяют подключить Azure OpenAI, Anthropic или любой OpenAI-совместимый эндпоинт; со своим провайдером вход в GitHub не нужен.

2026-05-28

Выходит VS Code 1.122: провайдер Custom Endpoint попадает в Stable с API Chat Completions, Responses и Messages, а BYOK с этого выпуска работает без входа в GitHub.

2026-07-14

GitHub Copilot для JetBrains расширяет BYOK: можно настроить OpenAI-совместимые пользовательские эндпоинты. В анонсе упомянута только совместимость с OpenAI, поэтому Claude через QCode этим путём недоступен.

Подтверждено и не проверено

Подтверждено (дословно на официальных страницах)

Всё ниже можно дословно проверить в документации GitHub, changelog GitHub, документации VS Code или QCode: Custom Endpoint в VS Code поддерживает Chat Completions, Responses и Anthropic Messages, vendor равен customendpoint; у Copilot CLI ровно три типа провайдера, openai, azure и anthropic, причём openai означает эндпоинт, совместимый с OpenAI Chat Completions; модели для CLI должны поддерживать вызов инструментов и потоковую передачу, рекомендуемый контекст не меньше 128k; BYOK-моделям в VS Code тариф Copilot не нужен, а встроенным подсказкам и семантическому поиску нужен аккаунт GitHub; JetBrains поддерживает OpenAI-совместимые пользовательские эндпоинты с 2026-07-14; BYOK в GitHub Copilot app поддерживает Anthropic и любой OpenAI-совместимый HTTP-эндпоинт, требует входа в GitHub, но не тарифа Copilot; корпоративный BYOK находится в публичной предварительной версии. Со стороны QCode: модели Claude работают только на эндпоинте с протоколом Anthropic.

Не проверено или не опубликовано

По трём пунктам страница выводов не делает. Первое: может ли JetBrains обращаться к пользовательскому адресу по протоколу Anthropic, на официальных страницах не сказано, и документация QCode тоже помечает это как неподтверждённое, поэтому настройки Claude для JetBrains здесь нет. Второе: GitHub Copilot app и корпоративный BYOK официально перечисляют Anthropic и OpenAI-совместимые эндпоинты, но в документации QCode нет настройки ни для одного из них, поэтому конкретных значений полей здесь нет. Третье: документация QCode проверена на VS Code 1.138.0 и Copilot CLI v1.0.86; для более новых версий ориентируйтесь на подписи и имена полей в своём клиенте.

VS Code или Copilot CLI

VS Code Chat (Custom Endpoint)

Подходит для чата и агентов в редакторе. В одном chatLanguageModels.json можно держать группу Claude (messages) рядом с группой GPT и китайских моделей (chat-completions), и обе видны в выборе модели; для агентов toolCalling должен быть true. BYOK заменяет только чат, встроенные подсказки по-прежнему идут через GitHub.

Copilot CLI (переменные окружения BYOK)

Подходит для агентной работы в терминале. Четыре переменные окружения задают одну модель, активен только один набор; встроенные субагенты (explore, task, code-review) наследуют ту же конфигурацию. Со своим провайдером вход в GitHub необязателен, а ошибка в настройке даёт сообщение об ошибке, а не тихий переход на модели GitHub.

Шаги настройки

Шаг 1, VS Code 1.122 или новее: в палитре команд запустите Chat: Manage Language Models, выберите Add Models, затем Custom Endpoint; VS Code откроет chatLanguageModels.json. Шаг 2, группа для Claude: vendor customendpoint, в apiKey ключ cr_, созданный в консоли QCode, apiType messages, url полный адрес https://api.qcode.cc/api/v1/messages, toolCalling true, в models добавьте ID вроде claude-sonnet-5; name можно задать любое, в примере документации QCode Claude. Шаг 3, отдельная группа для GPT и китайских моделей: apiType chat-completions, url https://api.qcode.cc/openai/v1/chat/completions; GPT может работать и через responses с url https://api.qcode.cc/openai/v1/responses (этот эндпоинт обслуживает только модели GPT). Шаг 4, Copilot CLI с Claude: задайте COPILOT_PROVIDER_TYPE=anthropic, COPILOT_PROVIDER_BASE_URL=https://api.qcode.cc/api, в COPILOT_PROVIDER_API_KEY ключ cr_, в COPILOT_MODEL ID модели и запустите copilot. Шаг 5, CLI с GPT или китайскими моделями: тип openai, BASE_URL https://api.qcode.cc/openai/v1 (только до /v1, без /chat/completions); используйте один набор из двух, последний заданный перекрывает предыдущий. Шаг 6, проверка: отправьте сообщение выбранной модели; ответ 401 означает проблему с ключом, 404 с формой адреса.

В QCode

В QCode один ключ cr_ из консоли работает со всеми протоколами, а протокол определяется путём запроса: claude-sonnet-5, claude-sonnet-5-5 и claude-opus-5-5 идут на эндпоинт Anthropic https://api.qcode.cc/api; gpt-6.1-sol, glm-5.3 и deepseek-v4.1-flash на OpenAI-совместимый эндпоинт https://api.qcode.cc/openai/v1. Модель Claude на OpenAI-совместимом эндпоинте отклоняется (model_not_available_on_endpoint), поэтому часть Copilot, понимающая только OpenAI-совместимый протокол, до Claude не достанет; используйте messages в VS Code, тип anthropic в CLI или сам Claude Code. Claude Opus 4.7, снятая в Copilot 2026-10-02, и GPT-5.5, которую снимут 2026-10-19, по-прежнему вызываются в QCode как claude-opus-4-7 и gpt-5.5; актуальный список на /models. Оплата за токены, цена каждой модели на /models, отдельно от подписки Copilot; каждый запрос можно найти по ключу на probe.qcode.cc.

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

Можно ли использовать в GitHub Copilot свой ключ Claude API?

Да, если выбрать подходящее место. На 2026-10-07 Custom Endpoint в VS Code Chat поддерживает Anthropic Messages API, а в Copilot CLI есть тип провайдера anthropic, так что оба принимают пользовательский адрес для Claude. Пользовательский эндпоинт в JetBrains официально описан только как OpenAI-совместимый, а работает ли там тип Anthropic, на официальных страницах не подтверждено; в QCode модели Claude работают только на эндпоинте с протоколом Anthropic, поэтому подтверждённая настройка там охватывает лишь GPT и китайские модели.

Нужен ли тариф Copilot для BYOK?

Не всегда: для VS Code и GitHub Copilot app тариф официально не нужен, а для JetBrains, Xcode и корпоративного BYOK нужна лицензия Copilot. По документации VS Code, BYOK-модели работают без входа в GitHub и без тарифа Copilot; в Copilot CLI со своим провайдером вход в GitHub необязателен; GitHub Copilot app требует входа в GitHub, но со своим провайдером тариф Copilot не нужен. В анонсе BYOK для JetBrains и Xcode от 2025-09-11 указано, что нужна действующая лицензия Copilot. Корпоративный BYOK рассчитан на Copilot Business и Enterprise, пользователям нужны лицензия Copilot и доступ в интернет.

С BYOK встроенные подсказки тоже идут через мою модель?

Нет. Документация VS Code указывает, что семантическому поиску, встроенным подсказкам (автодополнению кода) и функциям на эмбеддингах по-прежнему нужен аккаунт GitHub, а BYOK применяется только к чату и служебным задачам; в примечаниях к 1.122 тоже сказано, что встроенные подсказки и next edit suggestions требуют входа в GitHub.

В VS Code url — корень или полный путь?

Полный путь. VS Code рекомендует полный адрес эндпоинта вместе с путём API, иначе сам добавит /v1 и путь. В документации QCode значения https://api.qcode.cc/api/v1/messages, https://api.qcode.cc/openai/v1/chat/completions и https://api.qcode.cc/openai/v1/responses. В Copilot CLI наоборот: COPILOT_PROVIDER_BASE_URL содержит только https://api.qcode.cc/api или https://api.qcode.cc/openai/v1. Ответ 404 обычно значит, что эти две формы перепутаны.

В рабочем аккаунте нет пользовательских моделей. Что делать?

Сначала попросите администратора проверить политику. По документации VS Code, администраторы пользователей Copilot Business или Enterprise могут выключить Bring Your Own Language Model Key in VS Code в настройках политик Copilot на GitHub.com, а документация GitHub говорит, что локальный BYOK в IDE отключается политикой предприятия или организации. Кроме того, модель видна агентам, только если поддерживает вызов инструментов (toolCalling равен true).

Можно ли настроить это с ключом QCode?

Да. Создайте ключ cr_ в консоли. В VS Code используйте messages с url https://api.qcode.cc/api/v1/messages для claude-sonnet-5, claude-sonnet-5-5 или claude-opus-5-5 и chat-completions с url https://api.qcode.cc/openai/v1/chat/completions для gpt-6.1-sol, glm-5.3 и других. В Copilot CLI используйте тип anthropic с https://api.qcode.cc/api. Оплата за токены; цены и текущий список моделей на /models.

Источники

BYOK в Copilot CLI: документ GitHub Adding LLM models to GitHub Copilot CLI и записи changelog GitHub от 2026-04-07 (Copilot CLI now supports BYOK and local models) и 2026-06-17 (корпоративные BYOK-модели в CLI). VS Code: документ AI language models in VS Code (BYOK и справочник Custom Endpoint) и примечания к выпуску VS Code 1.122. Два вида BYOK и поддерживаемые клиенты: документы GitHub Bring your own key for GitHub Copilot, Enabling custom models for GitHub Copilot in your enterprise и Adding LLM models to the GitHub Copilot app, а также записи changelog от 2026-06-23 (Copilot app), 2026-07-14 и 2025-09-11 (JetBrains). Снятие моделей: записи changelog GitHub от 2026-08-31, 2026-09-18 и 2026-10-02. Настройка на стороне QCode: страница документации QCode о GitHub Copilot (обновлена 2026-09-18) и страница об эндпоинтах и форматах API. Всё получено 2026-10-07.

Один ключ для Copilot

И VS Code, и Copilot CLI принимают эндпоинты QCode: Claude по протоколу Anthropic, GPT и китайские модели через OpenAI-совместимый эндпоинт, оплата за токены.

Читайте также

Шаги и цитаты на странице проверены 2026-10-07 по официальной документации GitHub и VS Code и документации QCode; изменения у вышестоящих сервисов возможны без уведомления. Подписи в клиенте и имена полей меняются от версии к версии, ориентируйтесь на свою; доступность моделей смотрите на /models.

Сначала попробуйте, потом решайте

Не уверены, какой тариф выбрать? Начните со «Стартового» ($8.57/мес), а при апгрейде остаток старого тарифа вернётся на баланс.