Главная / Обучение / GitHub Copilot Chat с Claude через шлюз: настройка пользовательской конечной точки, агентный режим и устранение ошибок
Claude в Copilot. Два изящных чертёжных инструмента работают бок о бок над листом с кодом; небольшой внешний разъём API дополняет образ совместной разработки.

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 включено по умолчанию, и администраторы могут отключить его с помощью политики **Использование собственного ключа языковой модели**.

Добавьте шлюз как пользовательскую конечную точку

  1. Откройте представление чата, откройте список выбора модели и выберите **Управление языковыми моделями** или выполните команду **Чат: управление языковыми моделями** из палитры команд.
  2. Выберите **Добавить модели**, затем провайдера **Пользовательская конечная точка**.
  3. Введите отображаемое имя и API-ключ шлюза.
  4. Выберите тип API **Messages**. Затем VS Code откроет chatLanguageModels.json для списка моделей.

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
      }
    ]
  }
]
Поле Почему
idID модели, отправляемый шлюзу
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?
Да. В чате VS Code выберите «Управление языковыми моделями», затем «Добавить модели» и провайдера Anthropic для собственного API Anthropic либо Custom Endpoint с типом API Messages для шлюза.
Можно ли изменить базовый URL Anthropic в Copilot?
Во встроенном провайдере Anthropic нельзя: он принимает только ключ. Используйте провайдер Custom Endpoint и задайте для поля url каждой модели адрес конечной точки /v1/messages на шлюзе.
Работают ли модели BYOK в режиме агента Copilot?
Да, если для модели задано toolCalling: true. Встроенные инструменты и серверы MCP продолжают работать; встроенные дополнения кода по-прежнему предоставляет Copilot.
Нужна ли подписка Copilot для использования собственной модели?
Начиная с VS Code 1.122 — нет: модели BYOK работают без входа в GitHub и тарифного плана Copilot. Организации Business и Enterprise могут отключить эту возможность с помощью политики.
Начните использовать Claude за несколько минут

Получите ключ API — учётная запись Anthropic и запись в лист ожидания не нужны.

Получить ключ API

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.

Другие руководства по Claude API

Как получить ключ Claude APIКак устроены цены Claude APIСамый дешевый способ использования API ClaudeБезлимитный Cursor с API ClaudeБезлимитный доступ к Claude CodeШлюз API Claude и прямой доступ к Anthropic: сравнениеИспользуйте Claude с OpenAI SDK: совместимая с OpenAI конечная точка, потоковая передача, инструменты и ограниченияОбъяснение моделей Claude: сравнение Claude Opus, Sonnet, Haiku и Fable — все модели Claude API, названия моделей Anthropic и цены (2026)Оплата API Claude криптовалютойДоступ к API Claude без листа ожиданияКак сократить расход токенов ClaudeБезлимитный Cline с API ClaudeБезлимитный Roo Code с API ClaudeБезлимитный Claude в IDE JetBrainsAider с Claude через шлюз: ANTHROPIC_API_BASE, файлы конфигурации, режим архитектора и исправленияБезлимитный Claude в VS CodeКонфигурация OpenCode для Claude: настройка opencode.json, модели и распространённые ошибкиHermes Agent с Claude через шлюз: настройка пользовательского провайдера, контроль расходов и исправленияЗапуск OpenClaw с Claude без ограниченийЧто означает API, совместимый с AnthropicКлюч API Claude Code — ANTHROPIC_API_KEY: как получить, настроить и когда вместо него использовать claude setup-tokenРасходы на API Claude Code — цены и способы их снизитьОбъяснение ошибок API Claude: ошибка сервера 500, перегрузка 529, лимит запросов 429, некорректный запрос 400 — и исправление каждой из нихКак купить кредиты Claude API — и почему кредиты Claude лучше любого предложения «купить аккаунт Claude»Бесплатный API Claude: существует ли бесплатный ключ API Claude и что действительно бесплатно в 2026?API Claude или подписка Claude Pro/Max — что выбратьCodex CLI с пользовательским провайдером: config.toml, модели GPT и Claude, расширение для IDE и исправленияПодключение Claude к n8nМаршрутизация LiteLLM к ClaudeИспользование Claude в Kilo CodeПодключите Zed к Claude через шлюзПодключите Cherry Studio к ClaudeChatAnthropic в LangChain: импорт, base_url, потоковая передача, инструменты и ошибкиAnthropic Python SDK: установка, настройка base_url, потоковая передача и обработка ошибокClaude с Vercel AI SDK: baseURL в createAnthropic, потоковая передача и устранение проблемИспользуйте Factory Droid с ClaudeКак устроен API Claude CodeИнтеграция API Claude в ваше приложениеКак пользоваться Claude без ограничений — и почему «взломанного Claude Code» не существует

Другие гайды по Claude API

Что означает API, совместимый с AnthropicAnthropic Python SDK: установка, настройка base_url, потоковая передача и обработка ошибокКак купить кредиты API ClaudeСамый дешевый способ использования API ClaudeОбъяснение ошибок API Claude: ошибка сервера 500, перегрузка 529, лимит запросов 429, некорректный запрос 400 — и исправление каждой из нихБесплатный API Claude: существует ли бесплатный ключ API Claude и что действительно бесплатно в 2026?Интеграция API Claude в ваше приложениеОбъяснение моделей Claude: сравнение Claude Opus, Sonnet, Haiku и Fable — все модели Claude API, названия моделей Anthropic и цены (2026)Как устроены цены Claude APIШлюз API Claude и прямой доступ к Anthropic: сравнениеAPI Claude или подписка Claude Pro/Max — что выбратьОплата API Claude криптовалютойДоступ к API Claude без листа ожиданияКак устроен API Claude CodeРасходы на API Claude Code — цены и способы их снизитьКлюч API Claude Code — ANTHROPIC_API_KEY: как получить, настроить и когда вместо него использовать claude setup-tokenКак получить безлимитный доступ к ClaudeКак получить ключ Claude APIКак сократить расход токенов ClaudeИспользуйте Claude с OpenAI SDK: совместимая с OpenAI конечная точка, потоковая передача, инструменты и ограниченияHermes Agent с Claude через шлюз: настройка пользовательского провайдера, контроль расходов и исправленияЗапуск OpenClaw с Claude без ограниченийЧто означает безлимитный доступ к API ClaudeКак получить безлимитный ключ API ClaudeБезлимитное использование Claude Code — без ограничений на токеныБезлимитный доступ к Claude Opus 4.8Безлимитное использование Claude — тарифы и ценыAider с Claude через шлюз: ANTHROPIC_API_BASE, файлы конфигурации, режим архитектора и исправленияПодключите Cherry Studio к ClaudeБезлимитный доступ к Claude CodeБезлимитный Cline с API ClaudeCodex CLI с пользовательским провайдером: config.toml, модели GPT и Claude, расширение для IDE и исправленияРабота в Cursor с безлимитным доступом к ClaudeИспользуйте Factory Droid с ClaudeБезлимитный Claude в IDE JetBrainsИспользование Claude в Kilo CodeChatAnthropic в LangChain: импорт, base_url, потоковая передача, инструменты и ошибкиМаршрутизация LiteLLM к ClaudeПодключение Claude к n8nКонфигурация OpenCode для Claude: настройка opencode.json, модели и распространённые ошибкиБезлимитный Roo Code с API ClaudeClaude с Vercel AI SDK: baseURL в createAnthropic, потоковая передача и устранение проблемБезлимитный Claude в VS CodeПодключите Zed к Claude через шлюз