
GitHub Copilot Chat с Claude через шлюз: настройка Custom Endpoint, режим агента и исправления
Чат VS Code может работать с моделями, которые вы подключаете самостоятельно. Встроенный провайдер Anthropic принимает только ключ API и не содержит поля для другого адреса, поэтому шлюз добавляется через провайдера пользовательской конечной точки. Выберите тип API Messages и перечислите модели в chatLanguageModels.json. Эта возможность доступна в стабильной версии VS Code начиная с версии 1.122.
Что доступно при использовании собственного ключа
| Функция | С собственной моделью |
|---|---|
| Чат, вопросы и планирование | Да |
| Агентный режим, встроенные инструменты и серверы MCP | Да, если модель помечена toolCalling: true |
| Встроенные подсказки (дополнение кода) и предложения следующих правок | Нет: их по-прежнему предоставляет GitHub Copilot |
| Семантический поиск и другие функции на основе эмбеддингов | Нет: для них по-прежнему нужна учётная запись GitHub |
Начиная с VS Code 1.122, эти модели работают без входа в GitHub и без тарифного плана Copilot. В Copilot Business и Enterprise BYOK включено по умолчанию, и администраторы могут отключить его с помощью политики **Использование собственного ключа языковой модели**.
Добавьте шлюз как пользовательскую конечную точку
- Откройте представление чата, откройте список выбора модели и выберите **Управление языковыми моделями** или выполните команду **Чат: управление языковыми моделями** из палитры команд.
- Выберите **Добавить модели**, затем провайдера **Пользовательская конечная точка**.
- Введите отображаемое имя и API-ключ шлюза.
- Выберите тип API **Messages**. Затем VS Code откроет
chatLanguageModels.jsonдля списка моделей.
chatLanguageModels.json
[
{
"name": "AI Prime Tech",
"vendor": "customendpoint",
"apiKey": "${input:aiprimeApiKey}",
"apiType": "messages",
"models": [
{
"id": "claude-sonnet-5",
"name": "Claude Sonnet 5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
},
{
"id": "claude-opus-5-5",
"name": "Claude Opus 5.5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
},
{
"id": "claude-haiku-4-5",
"name": "Claude Haiku 4.5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 168000,
"maxOutputTokens": 32000
}
]
}
]| Поле | Почему |
|---|---|
id | ID модели, отправляемый шлюзу |
url | Полный адрес конечной точки. VS Code использует URL, оканчивающийся на /messages без изменений; укажите полный путь, чтобы избежать догадок |
toolCalling: true | Требуется для режима агента. Без этой возможности модель не отображается в списке для агентов |
maxInputTokens + maxOutputTokens | Их сумма не должна превышать контекстное окно модели |
apiKey: ${input:...} | VS Code запрашивает ключ один раз и сохраняет его, поэтому ключ не записывается в файл |
При выборе типа Messages VS Code отправляет ключ в заголовке x-api-key — именно этого ожидает шлюз. ID моделей должны в точности совпадать с ID на шлюзе.
Модели GPT с тем же ключом
Провайдер Custom Endpoint также поддерживает форматы OpenAI. Чтобы добавить модели GPT с ключом из группы Codex на шлюзе, добавьте второго провайдера с "apiType": "chat-completions" и URL моделей вида https://aiprimetech.io/v1/chat/completions. Ключ предоставляет доступ только к моделям своей группы, поэтому для Claude и GPT обычно нужны отдельные записи с отдельными ключами.
Устаревшая настройка github.copilot.chat.customOAIModels и провайдер **OpenAI Compatible** объявлены устаревшими в пользу Custom Endpoint. Перенесите старые записи в chatLanguageModels.json.
Устранение неполадок
| Что вы видите | Причина | Решение |
|---|---|---|
| Модель не отображается в списке выбора | Требуется перезагрузка, либо toolCalling имеет значение false, либо рабочая область находится в режиме ограничений | Перезапустите VS Code, задайте toolCalling: true, разрешите доверие к рабочей области |
| В списке провайдеров нет Custom Endpoint | Версия VS Code старше 1.122, либо BYOK отключено вашей организацией | Обновите VS Code; уточните у администратора настройки политики BYOK |
401 / недействительный API-ключ | Сохранённый ключ неверен или относится к другой конечной точке | Нажмите значок шестерёнки рядом с провайдером, затем **Обновить API-ключ** |
| Модель не поддерживается | В id не совпадает с ID модели на шлюзе | Используйте ID из таблицы ниже |
| Ошибки контекста или токенов | maxInputTokens и maxOutputTokens превышает размер окна | Уменьшите maxInputTokens |
Concurrency limit exceeded | Несколько агентов или окон работают одновременно с одним ключом | Сократите число параллельных запусков |
Для подробной диагностики выполните команду **Разработчик: задать уровень журналирования**, выберите **Трассировка**, затем откройте **Вывод** и выберите **GitHub Copilot Chat**. Представление отладки чата показывает точные запросы. Строка журнала, сообщающая, что регистрация BYOK провайдеров отменена, поскольку политика запрещает их использование, указывает на политику организации.
| Идентификатор модели | Для каких задач |
|---|---|
claude-sonnet-5 | Основной выбор для программирования и работы с агентами: быстрая, мощная, со средней стоимостью. |
claude-opus-5-5 | Более сложные рассуждения, масштабный рефакторинг, длительная работа агентов. |
claude-fable-5-1 | Самая мощная и дорогая; используйте её для наиболее сложных задач. |
claude-haiku-4-5 | Недорогая и быстрая: заголовки, краткие изложения, классификация, небольшие шаги. |
Предпочитаете терминал? С тем же ключом работает Claude Code в VS Code через собственное расширение.
Часто задаваемые вопросы
Можно ли использовать собственный API-ключ Claude в GitHub Copilot?
Можно ли изменить базовый URL Anthropic в Copilot?
Работают ли модели BYOK в режиме агента Copilot?
Нужна ли подписка Copilot для использования собственной модели?
Получите ключ API — учётная запись Anthropic и запись в лист ожидания не нужны.
Получить ключ APIAI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.