Ferramentas de código

GitHub Copilot CLI

Conecte o GitHub Copilot CLI ao TokenLab com BYOK

Visão geral

O GitHub Copilot CLI pode se conectar a qualquer endpoint compatível com OpenAI Chat Completions. O TokenLab funciona através das variáveis de ambiente BYOK do Copilot CLI.

Instalação

Com o Node.js 22 ou superior, instale via npm:

npm install -g @github/copilot@1.0.85

No macOS ou Linux, você também pode usar o Homebrew:

brew install --cask copilot-cli

Verifique a instalação:

copilot --version

Configurar o TokenLab

Defina as variáveis do provedor antes de iniciar o Copilot CLI:

Use as instruções do terminal do Início Rápido para macOS, Linux, WSL ou Windows PowerShell para definir a TOKENLAB_API_KEY sem colocar a chave no histórico de comandos. Inicie o Copilot CLI a partir desse terminal. Para uso persistente, utilize seu gerenciador de segredos local; não adicione uma chave em texto simples ao seu perfil de shell.

Estas variáveis aplicam-se apenas a esta inicialização; sua conta salva, modelo padrão e configurações de permissão permanecem inalterados. Inicie normalmente sem as variáveis para usar sua configuração anterior. Não as torne persistentes em seu perfil de shell.

COPILOT_PROVIDER_TYPE=openai COPILOT_PROVIDER_BASE_URL=https://api.tokenlab.sh/v1 COPILOT_PROVIDER_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" copilot --model claude-sonnet-5-5
VariávelValor TokenLab
COPILOT_PROVIDER_TYPEopenai
COPILOT_PROVIDER_BASE_URLhttps://api.tokenlab.sh/v1
COPILOT_PROVIDER_API_KEYSua chave de API do TokenLab
COPILOT_MODELUm ID de modelo ativo, por exemplo claude-sonnet-5-5

O GitHub exige que o modelo selecionado suporte tanto streaming quanto chamadas de ferramentas (tool calling). O claude-sonnet-5-5 suporta chamadas de ferramentas e possui uma janela de contexto maior que o mínimo de 128K recomendado pelo GitHub.

Verificação

Dentro do Copilot CLI, peça primeiro uma ação de leitura, como:

Inspect this repository and summarize its top-level structure. Do not modify files.

Salvar configurações ou listar modelos não verifica uma chave ou uma solicitação concluída. Um prompt utiliza o saldo do TokenLab. Verifique a resposta e seu registro de solicitação correspondente antes de tentar usar ferramentas; solicitações auxiliares também podem ser cobradas.

Para ver as configurações de provedor que o Copilot CLI documenta, execute:

copilot help providers

Gerar imagens e vídeos no mesmo agente

O Copilot CLI também pode criar imagens e vídeos curtos com o servidor MCP do TokenLab. Cada geração é paga com o mesmo saldo do TokenLab. Mescle esta entrada em ~/.copilot/mcp-config.json. O Copilot CLI passa apenas o PATH para o servidor, portanto, ambas as variáveis vão em env:

{
  "mcpServers": {
    "tokenlab": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
      },
      "tools": ["*"]
    }
  }
}

Substitua <TOKENLAB_API_KEY> pela sua chave apenas neste arquivo local. Inicie o Copilot CLI e execute /mcp show tokenlab para verificar a conexão. Em seguida, tente:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video retorna um ID de tarefa. O agente chama get_task_status até que o vídeo esteja pronto. Veja Adicionar servidores MCP ao Copilot CLI para outras configurações.

Solução de problemas

Não faça commit de chaves de API em scripts de shell ou arquivos de configuração rastreados pelo Git. Rotacione qualquer chave que tenha sido exposta no histórico do terminal, capturas de tela ou logs.

Nesta página