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.85No macOS ou Linux, você também pode usar o Homebrew:
brew install --cask copilot-cliVerifique a instalação:
copilot --versionConfigurar 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ável | Valor TokenLab |
|---|---|
COPILOT_PROVIDER_TYPE | openai |
COPILOT_PROVIDER_BASE_URL | https://api.tokenlab.sh/v1 |
COPILOT_PROVIDER_API_KEY | Sua chave de API do TokenLab |
COPILOT_MODEL | Um 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 providersGerar 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.