GitHub Copilot CLI vs Claude Code: o limite do BYOK e as duas cobranças

Ambos são agentes de codificação no terminal atuais e em desenvolvimento ativo, e a decisão não é sobre qual escreve código melhor — é sobre qual saída você precisa. O GitHub Copilot CLI documenta um caminho BYOK com três tipos de provedor — openai, que abrange qualquer endpoint compatível com OpenAI Chat Completions, além de azure e anthropic — e esse caminho elimina a exigência de uma conta do GitHub, ao custo de três recursos hospedados pelo GitHub. O Claude Code fala apenas formatos no padrão Anthropic, sem um caminho compatível com OpenAI, e a Anthropic escreve que não oferece suporte ao roteamento do Claude Code para modelos que não sejam Claude por meio de qualquer gateway. Todo o restante desta comparação decorre dessa assimetria.

Referências de versão, verificadas em 18 de setembro de 2026. A versão estável mais recente do Copilot CLI é v1.0.86, publicada em 17 de setembro de 2026, distribuída no npm como @github/copilot com um binário copilot. O npm do Claude Code, latest, estava na versão 2.1.276, e stable na versão 2.1.267, com node >= 22 obrigatório.

Primeiro, certifique-se de que está comparando o produto atual

A maior parte dos textos que aparecem bem posicionados para “Copilot CLI” descreve uma ferramenta diferente e descontinuada. A extensão gh copilot — oficialmente “GitHub Copilot in the CLI” — foi descontinuada em 25 de outubro de 2025 em favor do GitHub Copilot CLI, e seu repositório está arquivado. Ela oferecia gh copilot suggest e gh copilot explain e nada mais: sem loop de agente, escolha de modelo ou endpoint personalizado. Se uma página disser para você executar gh extension install github/gh-copilot, ela trata do produto aposentado, e nenhum de seus preços ou configurações se aplica.

O erro equivalente no lado do Claude é tratar o Claude Code como uma ferramenta de terminal. A visão geral da Anthropic informa que ele é executado no terminal, em extensões de IDE, em um aplicativo para desktop e na web, compartilhando os mesmos arquivos CLAUDE.md, configurações e servidores MCP entre eles. A CLI é uma superfície. Observe também que a documentação mudou: docs.claude.com/en/docs/claude-code/* agora redireciona para code.claude.com/docs/en/*.

Quem deve escolher qual

Escolha o GitHub Copilot CLI se seu trabalho já está no GitHub e você quer os recursos do lado do servidor — /delegate para o agente de codificação na nuvem, o servidor MCP do GitHub e o GitHub Code Search — ou se precisa que um único agente execute modelos de vários laboratórios. O caminho BYOK é amplo em termos de protocolo: três tipos de provedor, com openai cobrindo qualquer endpoint compatível com OpenAI Chat Completions. Ambas as ferramentas podem ser executadas sem uma conta na empresa que as desenvolve — o Copilot CLI com BYOK, o Claude Code com uma credencial de gateway — portanto, isso não é o que as diferencia; a amplitude de protocolos é.

Escolha o Claude Code se você quer modelos Claude e deseja manter o próprio agente intacto, independentemente da origem dos tokens. Apontá-lo para um gateway mantém o agente, as ferramentas, o modelo de permissões e os arquivos de instruções inalterados. O custo está listado abaixo: os recursos de identidade do claude.ai, além dos padrões que a Anthropic documenta como diferentes atrás de uma URL base personalizada — o streaming refinado de ferramentas e a descoberta de modelos pelo gateway ficam desativados, a menos que você os habilite. Se você trabalha em uma IDE, um aplicativo para desktop e o terminal no mesmo repositório, o design de superfície compartilhada é uma vantagem real que nenhuma tabela de recursos captura.

Quanto ao modelo de execução, ambos são executados localmente e ambos controlam ferramentas. A referência programática do Copilot CLI documenta --allow-tool, --deny-tool, --allow-all-tools, -p para executar um prompt de forma não interativa, e --fleet para subagentes paralelos; a referência de config-dir documenta as configurações do sandbox, e a referência de comandos nomeia os modos standard, plan e autopilot. A página conceitual do Copilot CLI documenta o ACP, o Agent Client Protocol, como um padrão aberto que permite usar o Copilot CLI como agente em ferramentas de terceiros, IDEs e sistemas de automação compatíveis. Nada na referência programática torna --allow-all-tools um requisito de -p: eles são listados como opções independentes. O aviso está na página conceitual: com uma opção de aprovação automática como --allow-all-tools, o Copilot tem o mesmo acesso aos seus arquivos que você e pode executar qualquer comando de shell que você possa, sem perguntar antes.

Quanto ao custo de migração, a assimetria favorece deixar o Claude Code. A referência de instruções personalizadas do Copilot CLI lista CLAUDE.md como um arquivo de instruções descoberto e também lê .claude/CLAUDE.md; seu changelog registra que os arquivos de configuração de hooks passaram a aceitar a estrutura aninhada de matchers/hooks do Claude Code. As convenções do seu repositório são transportadas quase sem custo nessa direção.

Lado a lado

Duas cobranças com formatos diferentes

A cobrança do Copilot mudou: não é mais “uma solicitação premium por prompt”. A página conceitual do Copilot CLI informa que os créditos de IA são consumidos com base no número de tokens processados, e a página de planos define 1 crédito de IA como US$0,01. Os créditos não são acumulados: os não utilizados são perdidos, e a franquia é redefinida às 00:00:00 UTC do primeiro dia de cada mês. Os preços e as franquias de créditos dos planos abaixo vêm da documentação de planos do GitHub, que também é a fonte da divisão entre base e flex. Essa página informa apenas um total por usuário para Business e Enterprise; o fato de esses créditos serem agrupados no nível da entidade de cobrança e de o uso além da franquia continuar à tarifa publicada por crédito vem, em vez disso, da página de cobrança da organização.

O lado do Claude, de claude.com/pricing: Free US$0, Pro US$17 por mês na cobrança anual (US$200 antecipados) ou US$20 mensais, Max A partir de US$100 por mês, assentos Team standard US$20 anuais ou US$25 mensais, assentos Team premium US$100 anuais ou US$125 mensais, Enterprise US$20 por assento por mês, cobrado anualmente, mais o uso às tarifas da API. A página não informa nenhum valor para o nível Max 20x, portanto este guia não informa nenhum — verifique o valor em seu próprio checkout. A mecânica das janelas dos planos está em Limites do Claude Pro e Max.

Quanto custa uma sessão por token

O cartão de tarifas de modelos e preços do GitHub correspondia exatamente aos preços de tabela da própria Anthropic nos quatro modelos abaixo quando ambos foram verificados em 18 de setembro de 2026. Esse é o fato que torna esta comparação viável: nesses quatro modelos, o Copilot revende Claude pelo preço de tabela, com um preço por assento à frente, e não com margem adicional. Por milhão de tokens, entrada / saída:

Leia a linha do modelo que você realmente executa, e não a tabela como um todo. Claude Sonnet 5 é o contraexemplo que mantém a comparação honesta: sua tarifa na Kunavo é igual à tarifa de tabela, portanto, nesse modelo, não há economia apenas no preço. A Anthropic também informa que a tarifa de US$2/US$10 do Sonnet 5 agora é padrão e que o aumento programado para 1º de setembro de 2026 não ocorrerá.

Uma estimativa ilustrativa, não uma medição. Suponha que uma sessão em Claude Sonnet 4.6 processe 600.000 tokens de entrada não armazenados em cache e 40.000 tokens de saída, sem leituras nem gravações de cache. À tarifa de tabela publicada, isso corresponde a US$2.40, o que representa 240 créditos de IA do GitHub retirados da franquia mensal. À tarifa atual do catálogo da Kunavo, a mesma aritmética de tokens resulta em US$1.68. Esses valores são produtos de contagens de tokens presumidas e tarifas publicadas — não uma tarefa medida, não um limite máximo de cobrança e não uma afirmação sobre qual ferramenta termina o trabalho usando menos tokens. Entradas armazenadas em cache, novas tentativas e chamadas de ferramentas alteram o valor real.

Duas ressalvas de cada lado. Os créditos do Copilot expiram mensalmente, portanto a franquia não utilizada é dinheiro já gasto; um saldo pré-pago não funciona sob o mesmo relógio. E, no Claude Code, a documentação de custos observa que a duração do cache de prompts é de uma hora em uma assinatura, mas de cinco minutos em créditos de uso ou uma chave de API, o que altera o custo real de uma sessão ociosa. O agregado publicado pela Anthropic, de cerca de US$13 por desenvolvedor por dia ativo, é seu próprio relatório empresarial; o GitHub não publica equivalente, portanto os dois não podem ser colocados lado a lado.

O limite do BYOK, que é a diferença real

A referência de BYOK do GitHub exige exatamente duas variáveis, COPILOT_PROVIDER_BASE_URL e COPILOT_MODEL. COPILOT_PROVIDER_TYPE tem como padrão openai, que a página descreve como abrangendo OpenAI, Ollama, vLLM, Foundry Local e qualquer outro endpoint compatível com a API OpenAI Chat Completions; os outros dois valores são azure e anthropic. O GitHub informa que os modelos precisam oferecer suporte a chamadas de ferramentas e streaming, e recomenda uma janela de contexto de pelo menos 128 mil tokens para obter os melhores resultados.

A página do protocolo de gateway do Claude Code é a imagem espelhada: a URL base é uma origem, e o cliente acrescenta /v1/messages por conta própria; anthropic-version e anthropic-beta devem ser encaminhados literalmente; o fluxo não pode ser armazenado em buffer (em uma conexão ANTHROPIC_BASE_URL, o Claude Code conta cada byte retransmitido, incluindo eventos SSE ping, e interrompe por padrão um fluxo que permanece silencioso por 300 segundos); e cache_control deve passar adiante, ou cada turno será discretamente cobrado como não armazenado em cache. A regra da credencial está na página de conexão do gateway, e não na de protocolo: ANTHROPIC_AUTH_TOKEN envia Authorization: Bearer, e ANTHROPIC_API_KEY envia x-api-key; uma credencial na variável errada chega em um cabeçalho que o gateway não lê, portanto a solicitação falha com um 401.

# Claude Code — documented, and the shape Kunavo's own setup page uses.
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Pin models Kunavo serves. Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models; the sonnet alias asks for Sonnet 5.5,
# which Kunavo does not serve — unpinned, /model sonnet 404s. The Opus 5.5
# pin needs Claude Code v2.1.280 or later (run: claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

# GitHub Copilot CLI — the variable NAMES are from GitHub's BYOK reference.
# Only BASE_URL and MODEL are required; COPILOT_PROVIDER_TYPE defaults to openai.
export COPILOT_PROVIDER_TYPE=anthropic      # or: openai | azure
export COPILOT_PROVIDER_BASE_URL=...        # see the note below: unverified
export COPILOT_PROVIDER_API_KEY=...
export COPILOT_MODEL=...                    # the PROVIDER's model id

O custo de cada caminho. A página de autenticação do GitHub informa que, com BYOK, a autenticação do GitHub não é necessária e o CLI se conecta diretamente ao provedor configurado; ela nomeia três recursos que ficam indisponíveis: /delegate, o servidor MCP do GitHub e o GitHub Code Search. A página de BYOK documenta COPILOT_OFFLINE=true como a variável do modo offline. Você também pode combinar BYOK com um login do GitHub para manter ambos. No lado do Claude Code, a página de conexão do gateway informa que uma credencial de gateway substitui o login do claude.ai, de modo que a assinatura não é usada e o tráfego é cobrado do proprietário da credencial; Remote Control e ditado por voz ficam indisponíveis, o Console deixa de receber métricas de uso, e configurações gerenciadas com forceLoginMethod ou forceLoginOrgUUID não podem coexistir com uma credencial de gateway.

Duas armadilhas que vale conhecer antes de depurar. A referência de config-dir do GitHub documenta ~/.copilot/providers.json e informa que, quando ele declara qualquer provedor ou modelo, tem precedência sobre as variáveis de ambiente COPILOT_PROVIDER_*, que chama de legadas — enquanto o guia de BYOK nunca menciona o arquivo. Um providers.json residual, portanto, vence silenciosamente suas exportações. A referência descreve o arquivo apenas como um objeto JSON com as chaves providers e models e não publica um esquema completo; por isso, nenhum exemplo dele é inventado aqui. Segundo, a grafia do ID do modelo: o exemplo de BYOK passa a grafia própria do provedor com hífens (claude-opus-4-5), enquanto a lista de modelos do GitHub escreve a mesma família com pontos. Com BYOK, passe o que seu provedor espera, não o que a lista do GitHub mostra.

Não verificado, deliberadamente. O GitHub não documenta qual caminho de URL o Copilot CLI acrescenta por tipo de provedor — o URL base do exemplo OpenAI já contém /v1, enquanto o exemplo do Ollama não contém — portanto este guia não afirma um URL base do Copilot CLI para nenhum endpoint, inclusive o da Kunavo. Também não há documentação sobre se o caminho BYOK Anthropic do Copilot CLI encaminha cache_control, cabeçalhos beta ou um anthropic-version específico; portanto, não é possível fazer estimativas de custo dependentes de cache por esse caminho.

Onde as próprias fontes do GitHub divergem

O README do github/copilot-cli contradiz a documentação do GitHub em três pontos, todos eles assuntos pesquisados por compradores. O README lista uma assinatura ativa do Copilot como pré-requisito, enquanto a documentação de planos e a página de planos colocam o Copilot CLI em todos os planos, incluindo o Free. O README descreve a cobrança como uma cota de solicitações premium reduzida em uma por prompt, enquanto a documentação descreve créditos de IA medidos por tokens. E o README afirma que copilot usa Claude Sonnet 4.5 por padrão, um modelo que a página de modelos de IA compatíveis nem sequer lista para o Copilot CLI. Onde houver conflito, prefira a documentação — e confirme o comportamento de plano e cobrança que sua própria conta realmente mostra.

Especificamente sobre o modelo padrão, nenhuma página da documentação do GitHub verificada aqui nomeia um. A referência programática fornece a ordem de resolução — uma definição de agente personalizada, depois --model, depois COPILOT_MODEL, depois o arquivo de configurações e, por fim, “o modelo padrão do CLI” — sem dizer qual modelo é esse; a página de seleção automática de modelos do GitHub lista o Copilot CLI entre os clientes nos quais uma seleção automática encaminha cada tarefa para um modelo. Considere a lista de modelos disponíveis dependente do plano e sujeita a mudanças, e leia-a em /model no produto, e não em nenhum artigo, inclusive este.

O que esta página não testou

Nenhum teste em tempo de execução de qualquer CLI foi realizado para este guia. Nada aqui é um resultado de compatibilidade, um benchmark ou uma afirmação de que qualquer uma das ferramentas funciona com a Kunavo — toda declaração de protocolo acima foi lida na documentação dos fornecedores. No lado do Claude Code, existe um guia de configuração da Kunavo publicado, que é uma configuração documentada e ainda não substitui a execução da sua própria tarefa. Para o Copilot CLI, não existe um guia de configuração da Kunavo, exatamente por isso a pergunta sobre o URL base acima permanece em aberto, em vez de ser respondida.

Se a opção que você deseja é usar o Claude Code, basta definir duas variáveis de ambiente e as quatro configurações que fixam os modelos no bloco acima — a URL base é a origem sem /v1, um detalhe abordado em ANTHROPIC_BASE_URL — e a cobrança é por token, descontada de um saldo pré-pago, com recarga mínima de $10 e sem assinatura. Crie uma conta na Kunavo para testar em uma tarefa real e comparar o valor registrado da cobrança com seu plano atual. Análises mais detalhadas dos custos estão em Preços do Claude Code e A melhor API para o Claude Code.

Perguntas frequentes

Documentação oficial, metadados de versões, dados do registro npm e preços dos planos verificados em 18 de setembro de 2026 em github.com, docs.github.com, code.claude.com, platform.claude.com, claude.com/pricing e registry.npmjs.org. As tarifas da Kunavo foram lidas do catálogo ativo; os totais calculados são aritmética ilustrativa de tokens.