Herramientas de código

GitHub Copilot CLI

Conecta GitHub Copilot CLI a TokenLab con BYOK

Descripción general

GitHub Copilot CLI puede conectarse a cualquier endpoint compatible con Chat Completions de OpenAI. TokenLab funciona a través de las variables de entorno BYOK de Copilot CLI.

Instalación

Con Node.js 22 o posterior, instala a través de npm:

npm install -g @github/copilot@1.0.85

En macOS o Linux, puedes usar Homebrew como alternativa:

brew install --cask copilot-cli

Verifica la instalación:

copilot --version

Configurar TokenLab

Establece las variables del proveedor antes de iniciar Copilot CLI:

Utiliza las instrucciones de terminal de Inicio rápido para macOS, Linux, WSL o Windows PowerShell para establecer TOKENLAB_API_KEY sin incluir la clave en el historial de comandos. Inicia Copilot CLI desde esa terminal. Para un uso persistente, utiliza tu gestor de secretos local; no añadas una clave en texto plano a tu perfil de shell.

Estas variables se aplican solo a este inicio; tu cuenta guardada, el modelo predeterminado y la configuración de permisos permanecen intactos. Inicia normalmente sin las variables para usar tu configuración anterior. No las hagas persistentes en tu 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
VariableValor de TokenLab
COPILOT_PROVIDER_TYPEopenai
COPILOT_PROVIDER_BASE_URLhttps://api.tokenlab.sh/v1
COPILOT_PROVIDER_API_KEYTu clave API de TokenLab
COPILOT_MODELUn ID de modelo activo, por ejemplo claude-sonnet-5-5

GitHub requiere que el modelo seleccionado admita tanto streaming como llamadas a herramientas (tool calling). claude-sonnet-5-5 admite llamadas a herramientas y tiene una ventana de contexto mayor que el mínimo de 128K recomendado por GitHub.

Verificación

Dentro de Copilot CLI, solicita primero una acción de solo lectura, como:

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

Guardar la configuración o listar modelos no verifica una clave ni una solicitud completada. Un prompt utiliza el saldo de TokenLab. Revisa la respuesta y su registro de solicitud correspondiente antes de probar herramientas; las solicitudes auxiliares también pueden ser facturadas.

Para ver la configuración del proveedor que documenta Copilot CLI, ejecuta:

copilot help providers

Generar imágenes y video en el mismo agente

Copilot CLI también puede crear imágenes y videos cortos con el servidor MCP de TokenLab. Cada generación se paga con el mismo saldo de TokenLab. Fusiona esta entrada en ~/.copilot/mcp-config.json. Copilot CLI solo pasa PATH al servidor, por lo que ambas variables van en 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": ["*"]
    }
  }
}

Reemplaza <TOKENLAB_API_KEY> con tu clave solo en este archivo local. Inicia Copilot CLI y ejecuta /mcp show tokenlab para comprobar la conexión. Luego intenta:

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 devuelve un ID de tarea. El agente llama a get_task_status hasta que el video esté listo. Consulta Añadir servidores MCP a Copilot CLI para otras configuraciones.

Solución de problemas

No incluyas claves API en scripts de shell o archivos de configuración rastreados por Git. Rota cualquier clave que haya sido expuesta en el historial de la terminal, capturas de pantalla o registros.

En esta página