Claude no Copilot. Dois instrumentos de desenho elegantes trabalhando lado a lado sobre uma folha de código, com um pequeno conector de API externa, sugerindo programação colaborativa.

GitHub Copilot Chat com Claude por meio de um gateway: configuração de Custom Endpoint, modo agente e correções

O chat do VS Code pode usar modelos fornecidos por você. O provedor Anthropic integrado aceita apenas uma chave de API, sem um campo para um endereço diferente, portanto um gateway é adicionado por meio do provedor de endpoint personalizado. Escolha o tipo de API Messages e liste os modelos em chatLanguageModels.json. Esse recurso faz parte da versão estável do VS Code desde a versão 1.122.

O que o uso da sua própria chave abrange

Recurso	Com seu próprio modelo
Chat, perguntas e planejamento	Sim
Modo agente, ferramentas integradas e servidores MCP	Sim, se o modelo estiver marcado `toolCalling: true`
Sugestões em linha (completamentos de código) e sugestões de próxima edição	Não: elas continuam vindo do GitHub Copilot
Pesquisa semântica e outros recursos baseados em embeddings	Não: eles ainda exigem uma conta do GitHub

Desde o VS Code 1.122, esses modelos funcionam sem entrar no GitHub e sem um plano do Copilot. No Copilot Business e Enterprise, BYOK está ativado por padrão, e os administradores podem desativá-lo com a política **Usar sua própria chave de modelo de linguagem**.

Adicione o gateway como um endpoint personalizado

Abra a visualização de chat, abra o seletor de modelos e escolha **Gerenciar modelos de linguagem**, ou execute **Chat: Gerenciar modelos de linguagem** na Paleta de Comandos.
Escolha **Adicionar modelos** e, em seguida, o provedor **Endpoint personalizado**.
Insira um nome de exibição e sua chave de API do gateway.
Selecione o tipo de API **Messages**. O VS Code então abre chatLanguageModels.json para a lista de modelos.

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
      }
    ]
  }
]

Campo	Por quê
`id`	O ID do modelo enviado ao gateway
`url`	O endpoint completo. O VS Code usa uma URL que termina em `/messages` sem alterações; forneça o caminho completo para evitar suposições
`toolCalling: true`	Obrigatório para o modo agente. Um modelo sem esse recurso não aparece para os agentes
`maxInputTokens` + `maxOutputTokens`	A soma deles não deve exceder a janela de contexto do modelo
`apiKey: ${input:...}`	O VS Code solicita a chave uma vez e a armazena, portanto ela não é gravada no arquivo

Com o tipo Messages, o VS Code envia a chave no cabeçalho x-api-key , que é o que o gateway espera. Os IDs dos modelos devem corresponder exatamente aos do gateway.

Modelos GPT com a mesma chave

O provedor Custom Endpoint também aceita os formatos da OpenAI. Para adicionar modelos GPT usando uma chave do grupo Codex do gateway, adicione um segundo provedor com "apiType": "chat-completions" e URLs de modelos no formato https://aiprimetech.io/v1/chat/completions. Uma chave acessa apenas os modelos do seu próprio grupo, portanto Claude e GPT geralmente precisam de entradas separadas com chaves separadas.

A antiga configuração github.copilot.chat.customOAIModels e o provedor **OpenAI Compatible** foram descontinuados em favor do Custom Endpoint. Mova as entradas antigas para chatLanguageModels.json.

Solução de problemas

O que você vê	Causa	Correção
O modelo não aparece no seletor	É necessário recarregar, ou `toolCalling` está definido como false, ou o espaço de trabalho está no Modo Restrito	Reinicie o VS Code, defina `toolCalling: true`, marque o espaço de trabalho como confiável
A lista de provedores não tem Custom Endpoint	VS Code anterior à versão 1.122, ou BYOK desativado pela sua organização	Atualize o VS Code; pergunte ao administrador sobre a política BYOK
`401` / chave de API inválida	A chave armazenada está incorreta ou pertence a outro endpoint	Ícone de engrenagem ao lado do provedor, depois Atualizar chave de API
Modelo não compatível	O `id` não corresponde a um ID de modelo do gateway	Use um ID da tabela abaixo
Erros de contexto ou de tokens	`maxInputTokens` mais `maxOutputTokens` excede a janela	Reduza `maxInputTokens`
`Concurrency limit exceeded`	Vários agentes ou janelas em execução ao mesmo tempo com uma única chave	Execute menos em paralelo

Para obter detalhes, execute **Desenvolvedor: Definir nível de log**, escolha **Rastreamento**, depois abra **Saída** e selecione **GitHub Copilot Chat**. A visualização de depuração do chat mostra as requisições exatas. Uma linha de log informando que BYOK provedores tiveram o registro removido porque a política não os permite indica uma política da organização.

ID do modelo	Use para
`claude-sonnet-5`	Padrão para programação e trabalho com agentes: rápido, eficiente e de preço intermediário.
`claude-opus-5-5`	Raciocínio mais complexo, grandes refatorações e execuções longas de agentes.
`claude-fable-5-1`	O mais capaz e mais caro; reserve-o para as tarefas mais difíceis.
`claude-haiku-4-5`	Barato e rápido: títulos, resumos, classificação e pequenas etapas.

Prefere o terminal? A mesma chave executa Claude Code no VS Code por meio de sua própria extensão.

Perguntas frequentes

Posso usar minha própria chave de API do Claude no GitHub Copilot?

Sim. No chat do VS Code, escolha Gerenciar modelos de linguagem, Adicionar modelos e, em seguida, o provedor Anthropic para a API da própria Anthropic, ou Custom Endpoint com o tipo de API Messages para um gateway.

Posso alterar a URL base da Anthropic no Copilot?

Não no provedor Anthropic integrado, que aceita apenas uma chave. Use o provedor Custom Endpoint e defina o campo url de cada modelo como o endpoint /v1/messages do gateway.

Os modelos BYOK funcionam no modo agente do Copilot?

Sim, quando o modelo está marcado com toolCalling: true. As ferramentas integradas e os servidores MCP continuam funcionando; as sugestões de conclusão de código em linha continuam vindo do Copilot.

Preciso de uma assinatura do Copilot para usar meu próprio modelo?

Desde o VS Code 1.122, não: os modelos BYOK funcionam sem login no GitHub nem plano do Copilot. Organizações Business e Enterprise podem desativar esse recurso por meio de uma política.

Comece a usar o Claude em minutos

Obtenha uma chave de API — sem precisar de conta na Anthropic nem de lista de espera.

Obtenha sua chave de API

AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários.