К содержимому

GitHub Copilot (VS Code) API: настройка и запуск

GitHub Copilot в VS Code подключает свои модели через Custom Endpoint. В поле apiType выбирается протокол: chat-completions, responses или messages. Покрываются чат, инструменты и MCP.

  • Тип: Редактор и IDE
  • Протокол: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages
  • Статус: Работает
Настройки сверены с официальной документацией клиента, 2026-10-02. Не проверено вручную: запуск клиента против шлюза не выполнялся.

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Вызов инструментовДа
Картинки на входеЧастичноЗависит от модели и флага возможностей в настройках.
АвтодополнениеНетВстроенные подсказки остаются на моделях Copilot.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

  1. Откройте чат VS Code, команду Chat: Manage Language Models и добавьте модели, провайдер Custom Endpoint.
  2. Выберите apiType: chat-completions для OpenAI Chat. В поле url укажите полный адрес https://relay-llm.ru/v1/chat/completions.
  3. Введите ключ в мастере: он сохранится как секрет. Затем добавьте модель по идентификатору из каталога, в примере gpt-5.6-luna.
  4. Выберите модель в чате Copilot.

Поля Custom Endpoint

text
Provider: Custom Endpoint
apiType: chat-completions
url: https://relay-llm.ru/v1/chat/completions
API key: YOUR_API_KEY
Model id: gpt-5.6-luna

Проверка

Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.

macOS и Linux

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Выберите модель в чате Copilot и отправьте «ping». Ответ пришёл, запись видна в журнале кабинета.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

OpenAI Responses

Путь /v1/responses поддержан, в том числе со стримингом. Параметры previous_response_id со значением resp_... и background: true возвращают 400: историю передавайте целиком в input. Идентификаторы элементов ответа шлюз заменяет своими.

Anthropic Messages

Работают модели, которые принимают этот протокол. Модели GPT по пути /v1/messages недоступны: шлюз не переводит протоколы друг в друга. Адрес для клиентов Anthropic указывается без /v1.

Ловушки

  • Ключ принимается только как секрет, созданный мастером: вписанный руками в chatLanguageModels.json ключ молча отвергается, и запросы уходят без авторизации.
  • Идентификатор модели в models должен совпадать с идентификатором из каталога.
  • Если в url нет пути API, VS Code добавит его сам и при необходимости вставит /v1. Документация советует давать полный адрес конечной точки, как в примере.
  • Встроенные подсказки в строке, предсказание правок и всё на эмбеддингах требуют входа в GitHub и тарифа Copilot. Свои модели покрывают чат, инструменты и MCP.
  • На тарифах Business и Enterprise администратор должен включить политику использования своего ключа модели. Расположение файла chatLanguageModels.json по системам в документации не описано: открывайте его из меню.

Официальная документация: GitHub Copilot (VS Code) API: настройка и запуск

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key