Documentação

GitHub Copilot CLI

O caminho BYOK do Copilot CLI usa quatro variáveis de ambiente e, segundo a própria documentação do GitHub, não exige login no GitHub. Aponte-o para o Kunavo e o agente usará um saldo pré-pago em vez de AI Credits — enquanto /delegate, o servidor MCP do GitHub e GitHub Code Search continuam vinculados a esse login.

Quatro variáveis de ambiente — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY e COPILOT_MODEL — colocam o Copilot CLI em seu próprio endpoint, e o GitHub documenta que BYOK não exige login do GitHub.

o shell a partir do qual você inicia o Copilot

# Set before you start Copilot CLI. Variable names and order are GitHub's;
# COPILOT_PROVIDER_BASE_URL and COPILOT_MODEL are the two marked Required.
export COPILOT_PROVIDER_BASE_URL=https://api.kunavo.com/v1   # see the note below
export COPILOT_PROVIDER_TYPE=openai                          # the default, shown for clarity
export COPILOT_PROVIDER_API_KEY=sk-kn-...
export COPILOT_MODEL=claude-sonnet-5

copilot

O GitHub não informa qual caminho o Copilot CLI acrescenta, então o /v1 acima é um exemplo prático, não uma regra. A página BYOK define o campo apenas como “A URL base do endpoint da API do seu provedor de modelos”, e os próprios exemplos apontam para as duas opções: o exemplo remoto compatível com OpenAI é https://api.openai.com/v1, enquanto os exemplos de Ollama e Anthropic usam as origens sem caminho. Esta página usa o formato remoto compatível com OpenAI porque esse é o caso do Kunavo. Se as solicitações retornarem 404, o sufixo está sendo duplicado — remova-o e use https://api.kunavo.com. Um 401 indica problema na chave, não na URL, e o curl abaixo permite distinguir os dois antes de depurar o CLI.

Um ~/.copilot/providers.json remanescente tem precedência silenciosa sobre essas exportações. A referência do diretório de configuração do GitHub diz que, quando esse arquivo declara qualquer provedor ou modelo, ele tem precedência sobre as variáveis COPILOT_PROVIDER_*, que a referência classifica como legadas — e o guia BYOK não menciona o arquivo. Se o CLI ignorar a URL base que você acabou de exportar, verifique esse arquivo primeiro. A mesma referência descreve o arquivo apenas como um objeto JSON com as chaves providers e models e não publica um esquema; por isso, não há exemplo dele nesta página. Para saber mais, o GitHub indica copilot help providers.

Esta configuração foi extraída da documentação oficial do próprio GitHub na data indicada abaixo. O Kunavo não executou o Copilot CLI contra seu endpoint — não houve uma sessão, uma interação transmitida em fluxo, uma ida e volta de ferramenta, e o mesmo vale para todos os outros clientes desta família. Uma página de configuração publicada não é um teste. O GitHub exige que um modelo BYOK ofereça suporte a chamadas de ferramentas e transmissão em fluxo; caso contrário, retorna um erro. Portanto, a primeira tarefa que você der ao CLI deve acessar um arquivo, em vez de apenas dizer olá.

O Kunavo não disponibiliza modelos de incorporação, conversão de texto em fala ou conversão de fala em texto, então esse endpoint responde a interações de chat e nada mais. GitHub Code Search, o servidor MCP do GitHub e /delegate são recursos do próprio GitHub que um provedor BYOK não substitui — o GitHub os documenta como indisponíveis sem login. Você pode mantê-los entrando na sua conta e também configurando um provedor.

Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de GitHub Copilot CLI.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
Verifique se há um ~/.copilot/providers.json desatualizado (ou o que quer que COPILOT_PROVIDERS_CONFIG indique). Se ele declarar um provedor ou modelo, terá precedência sobre tudo na etapa 3.
Exporte COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_API_KEY e COPILOT_MODEL conforme indicado acima. COPILOT_PROVIDER_TYPE tem o padrão openai, que o GitHub descreve como compatível com “qualquer outro endpoint compatível com a API OpenAI Chat Completions”.
Inicie copilot no mesmo shell — esses valores são lidos na inicialização, então um terminal aberto antes ainda terá os valores antigos.
Dê ao CLI uma tarefa que leia e edite um arquivo. O Copilot CLI precisa de chamadas de ferramentas e transmissão em fluxo pelo modelo. Uma primeira execução que teste ambas diz mais do que uma saudação. --model substitui COPILOT_MODEL em uma execução, caso você queira comparar dois IDs.

Verificado em “Usar seus próprios modelos LLM no GitHub Copilot CLI”, do GitHub em 21 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Esta é a versão resumida. O guia completo — escolha do modelo, custo de uma sessão real e modos de falha — está em Copilot CLI vs Claude Code — os limites do BYOK e as duas contas.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em GitHub Copilot CLI.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

ID do modelo	Entrada / saída da Kunavo	Onde se encaixa em GitHub Copilot CLI
`claude-sonnet-5`	$1.40 / $7.00	o modelo de trabalho padrão para sessões que editam arquivos
`claude-opus-5`	$3.50 / $17.50	planejamento de uma mudança em que errar sairia caro
`claude-haiku-4-5`	$0.70 / $3.50	interações baratas — triagem, resumos e o ciclo que roda o dia inteiro
`gpt-5-6-sol`	$2.00 / $12.00	uma segunda opinião de outra família, com a mesma chave e a mesma URL base

A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

A outra opção: `COPILOT_PROVIDER_TYPE=anthropic`

O GitHub documenta três tipos de provedor, e o Kunavo responde a dois dos formatos de comunicação: /v1/chat/completions para openai e /v1/messages para anthropic. O exemplo de Anthropic na página do GitHub usa quatro exportações, e sua URL base é a origem sem caminho https://api.anthropic.com:

COPILOT_PROVIDER_TYPE=anthropic
COPILOT_PROVIDER_BASE_URL — pelo formato do exemplo do GitHub, https://api.kunavo.com sem sufixo, já que a rota própria da Anthropic fica em /v1/messages nessa origem e o Kunavo a replica. Vale a mesma ressalva feita acima: o GitHub mostra um exemplo, não uma regra.
COPILOT_PROVIDER_API_KEY — sua chave sk-kn-. A interface Messages do Kunavo aceita a chave como x-api-key ou Authorization: Bearer, então a opção que o CLI escolher aqui será reconhecida.
COPILOT_MODEL — o ID esperado pelo seu provedor. O exemplo do GitHub usa uma grafia com hífens no estilo Anthropic, enquanto a lista de modelos compatíveis do próprio GitHub escreve as mesmas famílias com pontos. No BYOK, o ID é enviado ao seu endpoint; portanto, use a grafia da tabela acima.

Por que esta página começa com o tipo openai mesmo assim: a documentação do GitHub não esclarece se o caminho BYOK da Anthropic encaminha cache_control, anthropic-beta ou um anthropic-version específico. Isso afeta a cobrança em contextos repetidos — consulte cache de prompts — e esta página não está disposta a presumir uma resposta que não foi documentada. O tipo openai não deixa essa questão em aberto, então é o que tem um bloco de configuração preenchido.

Perguntas frequentes

Como direciono o GitHub Copilot CLI para um endpoint de API personalizado?

Defina variáveis de ambiente antes de iniciar o CLI. A página BYOK do GitHub indica duas como obrigatórias — COPILOT_PROVIDER_BASE_URL e COPILOT_MODEL — e acrescenta COPILOT_PROVIDER_API_KEY para endpoints que exigem autenticação. COPILOT_PROVIDER_TYPE usa openai como padrão, que o GitHub descreve como compatível com OpenAI, Ollama, vLLM, Foundry Local e qualquer outro endpoint compatível com a API OpenAI Chat Completions; os outros valores são azure e anthropic. Há uma ressalva documentada pelo GitHub em outro lugar: se ~/.copilot/providers.json declarar qualquer provedor ou modelo, ele terá precedência sobre todas essas variáveis.

A URL base do Copilot CLI precisa terminar em /v1?

A documentação do GitHub não esclarece isso. O campo é definido apenas como “A URL base do endpoint da API do seu provedor de modelos”, e os exemplos da própria página apontam para as duas opções: o exemplo remoto compatível com OpenAI é https://api.openai.com/v1, enquanto os exemplos de Ollama e Anthropic usam origens sem caminho. Para um endpoint compatível com OpenAI, comece pelo formato que o GitHub mostra para esse caso — https://api.kunavo.com/v1 — e, se as solicitações falharem com 404 em vez de 401, o sufixo está sendo duplicado, então remova-o. Um 404 aponta para a URL; um 401, para a chave. Uma solicitação curl simples à mesma URL base permite distinguir os dois antes de depurar o CLI.

O BYOK do GitHub Copilot CLI exige uma conta do GitHub?

Não. A documentação de autenticação do GitHub afirma que, quando o Copilot CLI é configurado com a chave de API do seu próprio provedor de LLM, não é necessário autenticar-se no GitHub e o CLI se conecta diretamente ao provedor configurado. Nesse caso, três recursos ficam indisponíveis: /delegate, o servidor MCP do GitHub e GitHub Code Search. Você também pode entrar na conta e configurar um provedor ao mesmo tempo para manter os três. O GitHub também documenta COPILOT_OFFLINE=true para ambientes em que o CLI não deve contatar os servidores do GitHub de forma alguma — embora isso só isole a rede se o provedor for local, pois uma URL base remota ainda recebe seus prompts e o contexto do código.

O Kunavo testou o GitHub Copilot CLI com seu endpoint?

Não. A configuração nesta página foi extraída da documentação BYOK oficial do próprio GitHub na data indicada, e nenhum conteúdo aqui é resultado de execução — não houve sessão, interação transmitida em fluxo nem ida e volta de ferramenta, e o mesmo vale para todos os outros clientes documentados aqui. O GitHub exige que um modelo BYOK ofereça suporte a chamadas de ferramentas e transmissão em fluxo; caso contrário, retorna um erro. Portanto, a primeira verificação honesta é sua: execute uma tarefa que leia e edite um arquivo e considere a cobrança registrada e o comportamento do CLI como evidências, não esta página.