Source: https://aiprimetech.io/pt/learn/use-claude-api-with-github-copilot/ [Início](/pt/) / [Aprenda](/pt/learn/) / GitHub Copilot Chat com Claude por meio de um gateway: configuração de endpoint personalizado, modo agente e correções # 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 chatLanguageModels.jsonCopiar ``` [ { "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](/pt/claude-code/vscode/) 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](/register) 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. ## Mais guias da API do Claude [Como obter uma chave de API do Claude](/pt/learn/how-to-get-a-claude-api-key/)[Preços da API Claude explicados](/pt/learn/claude-api-pricing-explained/)[A maneira mais barata de usar a API do Claude](/pt/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado com a API do Claude](/learn/use-claude-api-with-cursor/)[Acesso ilimitado ao Claude Code](/pt/learn/use-claude-api-with-claude-code/)[Gateway da API do Claude vs. acesso direto à Anthropic](/pt/learn/claude-api-vs-anthropic-direct/)[Use Claude com o SDK da OpenAI: endpoint compatível com OpenAI, streaming, ferramentas e limites](/pt/learn/openai-compatible-claude-api/)[Modelos Claude explicados: uma comparação entre Claude Opus, Sonnet, Haiku e Fable — todos os modelos da API Claude, nomes e preços dos modelos Anthropic (2026)](/pt/learn/claude-api-models-compared/)[Pagamento da API do Claude com criptomoedas](/pt/learn/claude-api-with-crypto-payment/)[Acesso à API do Claude sem lista de espera](/pt/learn/claude-api-without-waitlist/)[Como reduzir o uso de tokens do Claude](/pt/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado com a API do Claude](/pt/learn/use-claude-api-with-cline/)[Roo Code ilimitado com a API do Claude](/pt/learn/use-claude-api-with-roo-code/)[Claude ilimitado nas IDEs da JetBrains](/pt/learn/use-claude-api-with-jetbrains/)[Aider com Claude por meio de um gateway: ANTHROPIC_API_BASE, arquivos de configuração, modo arquiteto e correções](/pt/learn/use-claude-api-with-aider/)[Claude ilimitado no VS Code](/pt/learn/use-claude-api-with-vscode/)[Configuração do OpenCode para Claude: configuração do opencode.json, modelos e erros comuns](/pt/learn/use-claude-api-with-opencode/)[Hermes Agent com Claude por meio de um gateway: configuração de provedor personalizado, controles de custos e correções](/pt/learn/run-hermes-agent-with-claude-api/)[Executando OpenClaw ilimitado com Claude](/pt/learn/run-openclaw-with-claude-api/)[O que significa uma API compatível com a Anthropic](/pt/learn/anthropic-compatible-api/)[Chave de API do Claude Code — ANTHROPIC_API_KEY: como obtê-la, configurá-la e quando usar claude setup-token em seu lugar](/pt/learn/claude-code-api-key-setup/)[Custos da API do Claude Code — Preços e como reduzi-los](/pt/learn/claude-code-api-costs/)[Erros da API Claude explicados: erro de servidor 500, sobrecarga 529, limite de requisições 429, requisição inválida 400 — e a correção para cada um](/pt/learn/claude-api-errors-troubleshooting/)[Como comprar créditos da API do Claude — e por que um crédito do Claude é melhor do que qualquer oferta de "comprar conta do Claude"](/pt/learn/buy-claude-api-credits/)[API Claude gratuita: existe uma chave de API Claude gratuita e o que realmente é gratuito em 2026?](/pt/learn/claude-api-free-trial/)[API do Claude vs assinatura Claude Pro/Max — Qual escolher](/pt/learn/claude-api-vs-subscription/)[Codex CLI com um provedor personalizado: config.toml, modelos GPT e Claude, extensão para IDE e correções](/pt/learn/use-claude-api-with-codex/)[Conectando Claude ao n8n](/pt/learn/use-claude-api-with-n8n/)[Roteando LiteLLM para Claude](/pt/learn/use-claude-api-with-litellm/)[Usando Claude no Kilo Code](/pt/learn/use-claude-api-with-kilo-code/)[Conecte o Zed ao Claude por meio do gateway](/pt/learn/use-claude-api-with-zed/)[Conecte o Cherry Studio ao Claude](/pt/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic no LangChain: importação, base_url, streaming, ferramentas e erros](/pt/learn/use-claude-api-with-langchain/)[SDK de Python da Anthropic: instale, defina base_url, use streaming e trate erros](/pt/learn/anthropic-python-sdk/)[Claude com o Vercel AI SDK: baseURL de createAnthropic, streaming e correções](/pt/learn/use-claude-api-with-vercel-ai-sdk/)[Execute o Factory Droid com o Claude](/pt/learn/use-claude-api-with-factory-droid/)[A API do Claude Code, explicada](/pt/learn/claude-code-api/)[Como integrar a API do Claude à sua aplicação](/pt/learn/claude-api-integration/)[Como obter uso ilimitado do Claude — e por que não existe "Claude Code crackeado"](/pt/learn/get-unlimited-claude-usage/)