
GitHub Copilot Chat con Claude a través de una pasarela: configuración de Custom Endpoint, modo agente y soluciones
El chat de VS Code puede funcionar con modelos que aportes tú. El proveedor integrado de Anthropic solo acepta una clave de API, sin ningún campo para una dirección distinta, por lo que se añade una pasarela mediante el proveedor de endpoint personalizado. Elige el tipo de API Messages y enumera los modelos en chatLanguageModels.json. Forma parte de la versión estable de VS Code desde la versión 1.122.
Qué incluye el uso de tu propia clave
| Función | Con tu propio modelo |
|---|---|
| Chatear, preguntar y planificar | Sí |
| Modo agente, herramientas integradas y servidores MCP | Sí, si el modelo está marcado toolCalling: true |
| Sugerencias en línea (completado de código) y sugerencias de la siguiente edición | No: siguen procediendo de GitHub Copilot |
| Búsqueda semántica y otras funciones basadas en embeddings | No: siguen necesitando una cuenta de GitHub |
Desde VS Code 1.122, estos modelos funcionan sin iniciar sesión en GitHub y sin un plan de Copilot. En Copilot Business y Enterprise, BYOK está activado de forma predeterminada y los administradores pueden desactivarlo mediante la política **Usar tu propia clave de modelo de lenguaje**.
Añade la pasarela como un endpoint personalizado
- Abre la vista de chat, abre el selector de modelos y elige **Administrar modelos de lenguaje**, o ejecuta **Chat: Administrar modelos de lenguaje** desde la paleta de comandos.
- Elige **Añadir modelos** y, después, el proveedor **Endpoint personalizado**.
- Introduce un nombre para mostrar y la clave API de tu pasarela.
- Selecciona el tipo de API **Messages**. A continuación, VS Code abre
chatLanguageModels.jsonpara la lista de modelos.
chatLanguageModels.json
[
{
"name": "AI Prime Tech",
"vendor": "customendpoint",
"apiKey": "${input:aiprimeApiKey}",
"apiType": "messages",
"models": [
{
"id": "claude-sonnet-5",
"name": "Claude Sonnet 5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
},
{
"id": "claude-opus-5-5",
"name": "Claude Opus 5.5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
},
{
"id": "claude-haiku-4-5",
"name": "Claude Haiku 4.5",
"url": "https://aiprimetech.io/v1/messages",
"toolCalling": true,
"vision": true,
"maxInputTokens": 168000,
"maxOutputTokens": 32000
}
]
}
]| Campo | Por qué |
|---|---|
id | El ID del modelo que se envía a la pasarela |
url | El endpoint completo. VS Code utiliza una URL que termina en /messages tal cual; proporciona la ruta completa para evitar conjeturas |
toolCalling: true | Obligatorio para el modo agente. Un modelo sin esta opción no aparece para los agentes |
maxInputTokens + maxOutputTokens | Su suma no debe superar la ventana de contexto del modelo |
apiKey: ${input:...} | VS Code solicita la clave una sola vez y la guarda, por lo que no se escribe en el archivo |
Con el tipo Messages, VS Code envía la clave en el encabezado x-api-key , que es lo que espera la pasarela. Los ID de los modelos deben coincidir exactamente con los de la pasarela.
Modelos GPT con la misma clave
El proveedor Custom Endpoint también admite los formatos de OpenAI. Para añadir modelos GPT con una clave del grupo Codex de la pasarela, añade un segundo proveedor con "apiType": "chat-completions" y URL de modelos de https://aiprimetech.io/v1/chat/completions. Una clave solo da acceso a los modelos de su propio grupo, por lo que Claude y GPT normalmente necesitan entradas independientes con claves distintas.
La antigua opción github.copilot.chat.customOAIModels y el proveedor **OpenAI Compatible** están obsoletos y se han sustituido por Custom Endpoint. Traslada las entradas antiguas a chatLanguageModels.json.
Resolución de problemas
| Lo que ves | Causa | Solución |
|---|---|---|
| El modelo no aparece en el selector | Hace falta volver a cargar, o toolCalling es false, o el espacio de trabajo está en modo restringido | Reinicia VS Code, establece toolCalling: true, marca el espacio de trabajo como de confianza |
| La lista de proveedores no incluye Custom Endpoint | VS Code es anterior a 1.122, o tu organización ha deshabilitado BYOK | Actualiza VS Code; consulta al administrador sobre la política BYOK |
401 / clave API no válida | La clave guardada es incorrecta o pertenece a otro endpoint | Icono de engranaje junto al proveedor y, después, **Actualizar clave API** |
| Modelo no compatible | El id no coincide con un ID de modelo de la pasarela | Utiliza un ID de la tabla siguiente |
| Errores de contexto o de tokens | maxInputTokens junto con maxOutputTokens supera la ventana | Reduce maxInputTokens |
Concurrency limit exceeded | Varios agentes o ventanas se ejecutan a la vez con una sola clave | Ejecuta menos en paralelo |
Para obtener más detalles, ejecuta **Desarrollador: Establecer nivel de registro**, elige **Traza**, abre **Salida** y selecciona **GitHub Copilot Chat**. La vista de depuración del chat muestra las solicitudes exactas. Una línea del registro que indique que se ha anulado el registro de BYOK proveedores porque la política no los permite apunta a una política de la organización.
| ID del modelo | Úsalo para |
|---|---|
claude-sonnet-5 | Opción predeterminada para programación y trabajo con agentes: rápida, potente y de precio intermedio. |
claude-opus-5-5 | Razonamiento más complejo, refactorizaciones grandes y ejecuciones largas de agentes. |
claude-fable-5-1 | El más capaz y el más caro; resérvalo para las tareas más difíciles. |
claude-haiku-4-5 | Económico y rápido: títulos, resúmenes, clasificación y pasos pequeños. |
¿Prefieres la terminal? La misma clave permite ejecutar Claude Code en VS Code mediante su propia extensión.
Preguntas frecuentes
¿Puedo usar mi propia clave API de Claude en GitHub Copilot?
¿Puedo cambiar la URL base de Anthropic en Copilot?
¿Funcionan los modelos BYOK en el modo agente de Copilot?
¿Necesito una suscripción a Copilot para usar mi propio modelo?
Obtén una clave de API: no necesitas una cuenta de Anthropic ni estar en una lista de espera.
Obtén tu clave de APIAI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios.