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
- Статус: Работает
Что заработает
| Возможность | Отметка | Примечание |
|---|---|---|
| Чат | Да | |
| Вызов инструментов | Да | |
| Картинки на входе | Частично | Зависит от модели и флага возможностей в настройках. |
| Автодополнение | Нет | Встроенные подсказки остаются на моделях Copilot. |
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
- Откройте чат VS Code, команду Chat: Manage Language Models и добавьте модели, провайдер Custom Endpoint.
- Выберите
apiType:chat-completionsдля OpenAI Chat. В полеurlукажите полный адресhttps://.relay-llm.ru/ v1/ chat/ completions - Введите ключ в мастере: он сохранится как секрет. Затем добавьте модель по идентификатору из каталога, в примере
gpt-5.6-luna. - Выберите модель в чате Copilot.
Поля Custom Endpoint
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
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Выберите модель в чате Copilot и отправьте «ping». Ответ пришёл, запись видна в журнале кабинета.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
OpenAI Responses
Путь / поддержан, в том числе со стримингом. Параметры previous_response_id со значением resp_... и background: true возвращают 400: историю передавайте целиком в input. Идентификаторы элементов ответа шлюз заменяет своими.
Anthropic Messages
Работают модели, которые принимают этот протокол. Модели GPT по пути / недоступны: шлюз не переводит протоколы друг в друга. Адрес для клиентов Anthropic указывается без /.
Ловушки
- Ключ принимается только как секрет, созданный мастером: вписанный руками в
chatLanguageModels.jsonключ молча отвергается, и запросы уходят без авторизации. - Идентификатор модели в
modelsдолжен совпадать с идентификатором из каталога. - Если в
urlнет пути API, VS Code добавит его сам и при необходимости вставит/. Документация советует давать полный адрес конечной точки, как в примере.v1 - Встроенные подсказки в строке, предсказание правок и всё на эмбеддингах требуют входа в GitHub и тарифа Copilot. Свои модели покрывают чат, инструменты и MCP.
- На тарифах Business и Enterprise администратор должен включить политику использования своего ключа модели. Расположение файла
chatLanguageModels.jsonпо системам в документации не описано: открывайте его из меню.
Ссылки
Официальная документация: GitHub Copilot (VS Code) API: настройка и запуск
Подключение клиентов: общие сведения и все клиенты