Con una sola clave API de Capriole AI, usas GPT-6.2 Astra, Claude Fable 5.1, Opus 5.5 y Gemini 4 Carbon en GitHub Copilot CLI pagando hasta un 92% menos que los precios oficiales de la API.
Qué es GitHub Copilot CLI
GitHub Copilot CLI es el agente de programación de GitHub para la terminal. Su modo bring-your-own-key (BYOK) envía las solicitudes de modelo a un proveedor que defines con variables de entorno. Esta configuración lo dirige a Capriole AI.
Requisitos previos
Antes de empezar, asegúrate de tener:
- Una cuenta de Capriole AI (Regístrate aquí)
- Un plan Premium (USD 9 al mes, también incluye chat web ilimitado) o un plan Team, necesario para la clave API (Suscríbete)
- Una clave API de Capriole AI (Obtén tu clave)
Instalación
Instala GitHub Copilot CLI con npm:
Verifica la instalación:
No necesitas iniciar sesión en GitHub cuando COPILOT_PROVIDER_BASE_URL está definida.
Configuración
Validación de modelos
GitHub Copilot CLI 1.0.100 supera una prueba de lectura de archivos, escritura de archivos y respuesta final a través de Capriole AI con todos los modelos de la sección Modelos compatibles, usando los perfiles siguientes.
Copilot CLI usa un solo proveedor a la vez, así que elige el perfil de la familia de modelos que quieras. Cada perfil define dos valores de modelo:
COPILOT_PROVIDER_WIRE_MODEL es el ID de modelo de Capriole AI que Copilot envía.
COPILOT_PROVIDER_MODEL_ID es un modelo que Copilot conoce. Copilot lo usa para elegir sus herramientas, prompts y límites de tokens.
Modelos GPT
Los modelos GPT usan la API Responses:
Para GPT-6.2 Sol, define COPILOT_PROVIDER_MODEL_ID="gpt-6.1-sol" y COPILOT_PROVIDER_WIRE_MODEL="openai/gpt-6.2-sol".
Modelos Claude
Los modelos Claude usan Anthropic Messages:
Para Opus 5.5, define COPILOT_PROVIDER_WIRE_MODEL="claude-opus-5-5".
COPILOT_PROVIDER_BEARER_TOKEN envía la clave como token Bearer.
- La URL base no lleva
/v1, porque Copilot añade /v1/messages por su cuenta.
- Mantén
COPILOT_PROVIDER_MODEL_ID="claude-opus-4.6". Con un perfil más antiguo como claude-sonnet-4, Copilot envía un presupuesto de razonamiento y Opus 5.5 lo rechaza con requires adaptive thinking.
Modelos Gemini, Grok, GLM y Kimi
Estos modelos usan Chat Completions:
Para los demás modelos, cambia COPILOT_PROVIDER_WIRE_MODEL a google-latest, google/gemini-4-carbon, google/gemini-4-argon, google/gemini-3.8-flash, xai/grok-4.7 o zai/glm-5.3-flash.
Mantén COPILOT_PROVIDER_MODEL_ID="claude-sonnet-4". Con un perfil GPT como gpt-5.4, Copilot envía tipos de herramienta que estos modelos rechazan.
Para Kimi K3.1 Pro, define COPILOT_PROVIDER_MODEL_ID="claude-opus-4.6" y COPILOT_PROVIDER_WIRE_MODEL="moonshot/kimi-k3.1-pro". El perfil claude-sonnet-4 envía temperature: 0, que Kimi K3.1 Pro rechaza.
Para conservar un perfil, añade sus líneas a ~/.zshrc o ~/.bashrc y luego abre una terminal nueva.
Ejecutar GitHub Copilot CLI
Inicia Copilot CLI desde el directorio de tu proyecto:
Para una ejecución no interactiva, pasa un prompt con -p:
Modelos compatibles
openai-latest, claude-latest y google-latest siempre apuntan a nuestro modelo insignia más reciente de cada familia, actualmente GPT-6.2 Astra, Claude Fable 5.1 y Gemini 4 Carbon.
Solución de problemas
¿Por qué Copilot CLI devuelve un error de autenticación?
Confirma que CAPRIOLE_AI_API_KEY está exportada en el mismo shell. Para los modelos Claude, usa COPILOT_PROVIDER_BEARER_TOKEN, no COPILOT_PROVIDER_API_KEY.
¿Por qué las solicitudes fallan con errores de endpoint?
Para los modelos GPT, Gemini, Grok, GLM y Kimi, COPILOT_PROVIDER_BASE_URL es https://api.caprioletech.com/v1. Para los modelos Claude, es https://api.caprioletech.com sin /v1.
¿Por qué Opus 5.5 falla con requires adaptive thinking?
Define COPILOT_PROVIDER_MODEL_ID="claude-opus-4.6".
¿Por qué las solicitudes de Gemini, Grok, GLM o Kimi fallan con un error de herramientas?
Define COPILOT_PROVIDER_MODEL_ID="claude-sonnet-4", o "claude-opus-4.6" para Kimi K3.1 Pro. Un perfil GPT envía tipos de herramienta que solo aceptan los modelos de OpenAI.
Notas
- Copilot CLI ejecuta las herramientas de programación en tu equipo. Capriole AI procesa las solicitudes al modelo.
- Ejecuta
copilot help providers para ver todas las variables de entorno de BYOK.
- Gemini 4 Carbon razona más tiempo que Gemini 4 Argon, así que cada turno puede tardar más y usar más tokens. Para turnos más rápidos, usa
google/gemini-4-argon.
- Para usar la misma clave en tus otros agentes de programación, consulta Usa una sola clave API con agentes de programación.
- Referencias oficiales: Instalar GitHub Copilot CLI y Usar modelos BYOK en Copilot CLI.
Última modificación el 18 de noviembre de 2026