Cómo arreglar el error «No utility model is configured for ‘copilot-utility-small'» en VS Code

Tiempo de lectura: 2 minutos

Si usas modelos BYOK (Bring Your Own Key) en el Copilot Chat de VS Code —ya sea la API de Claude, un modelo local vía Ollama, o cualquier otro proveedor propio.

Es posible que desde la actualización a la versión 1.128.0 te haya empezado a saltar este error al usar el modo Agent:

No utility model is configured for 'copilot-utility-small' while the selected main agent model is BYOK.

En este tutorial te explico por qué pasa y cómo solucionarlo en dos minutos.

¿Por qué pasa esto?

Copilot Chat, además del modelo principal que eliges para conversar, usa por debajo un «utility model»: un modelo pequeño y rápido que se encarga de tareas auxiliares como detectar la intención de tus mensajes, generar títulos de chat, resumir contexto o escribir mensajes de commit.

Antes, si no configurabas nada, VS Code usaba automáticamente uno de los modelos propios de Copilot para estas tareas auxiliares, sin preguntarte. Desde la versión 1.128.0, si tienes seleccionado un modelo BYOK como modelo principal en modo Agent y no tienes un utility model configurado explícitamente, en vez de recurrir a un modelo por defecto, falla directamente y te muestra este error.

Es un comportamiento nuevo (y algo agresivo) que Microsoft ha introducido, y ya hay varios issues abiertos al respecto en el repositorio de VS Code (#324920 y #324007).

La solución

Opción 1: desde la interfaz de Settings

1. Abre VS Code.
2. Pulsa Ctrl+Shift+P (o Cmd+Shift+P en Mac) para abrir la paleta de comandos.
3. Escribe Preferences: Open Settings (UI) y dale a Enter.
4. En el buscador de Settings, escribe: chat.utilitySmallModel.
5. Selecciona un modelo de la lista disponible.
6. Reinicia VS Code para que aplique el cambio.

Opción 2: editando el settings.json directamente

Si la opción anterior no te aparece o prefieres editarlo a mano:

1. Ctrl+Shift+P → escribe Preferences: Open User Settings (JSON) → Enter.
2. Añade la siguiente línea dentro de tu settings.json, sustituyendo el valor por el nombre exacto del modelo que quieras usar:

"chat.utilitySmallModel": "nombre-de-tu-modelo"

3. Guarda el archivo y reinicia VS Code.

Puedes elegir también el modelo de Github por defecto.

Un consejo extra si trabajas con modelos locales (Ollama, llama.cpp, etc.)

Si usas un proveedor BYOK local con VRAM limitada, presta atención a esto: si configuras como utility model uno distinto al que usas como modelo principal, VS Code va a forzar que tu servidor local cargue y descargue modelos constantemente cada vez que Copilot necesite hacer una tarea auxiliar (por ejemplo, generar el título del chat).

Esto se traduce en lag notable, porque tu GPU tiene que hacer swap de modelos en memoria en cada petición pequeña.

Recomendación: configura como utility model el mismo modelo que ya tienes cargado como principal. Así evitas el overhead de recarga y todo va más fluido, aunque sea «matar moscas a cañonazos» usando un modelo grande para tareas pequeñas.

Resumen

Problema	Causa	Solución
Error No utility model is configured...	VS Code 1.128.0+ exige un utility model explícito cuando el modelo principal es BYOK	Configurar chat.utilitySmallModel en Settings

Es un bug/cambio de comportamiento reciente y probablemente lo pulan en próximas releases, pero mientras tanto esta configuración manual lo soluciona sin problema.