Herramientasia local
IA local para programar: conecta Ollama a VS Code
Configura una IA local para programar en VS Code con Ollama: prepara un modelo, conecta el editor y comprueba qué datos salen de tu equipo.
- Autor: humAIns
- 10 min de lectura
índice · 8 apartados
Una IA local para programar en VS Code combina un modelo descargado y ejecutado en tu ordenador con una extensión que lo muestra en el editor. Con Ollama, instala la extensión oficial, selecciona un modelo disponible en el chat y prueba una tarea con código ficticio. Así puedes evaluar la utilidad sin enviar un repositorio privado como primer experimento.
“Local” no significa privacidad absoluta: hay que distinguir la descarga inicial de la inferencia, comprobar si el modelo elegido es local o cloud y revisar las demás extensiones que interactúan con el proyecto. Esta guía explica la configuración vigente y una comprobación práctica antes de usar el asistente en tareas reales. Si aún comparas opciones, consulta IA en local o en la nube y la mejor IA para programar.
Qué significa que la IA funcione en local
En la inferencia local, el modelo se ejecuta en el equipo que tiene instalado Ollama. Antes, necesitas descargar el programa y los archivos del modelo; esa fase sí requiere conexión. Una vez descargado, una consulta al modelo local puede ejecutarse sin enviar el prompt a un proveedor remoto, siempre que la herramienta esté conectada a ese modelo y ninguna otra función externa intervenga.
La documentación de Ollama para VS Code admite tanto modelos locales como cloud. Por tanto, tener Ollama instalado no basta para concluir dónde se procesa una petición: fíjate en el modelo seleccionado. Un nombre con la etiqueta :cloud identifica un modelo en la nube en la documentación de Ollama; no lo confundas con una descarga local.
| Fase o componente | Qué ocurre | Qué conviene comprobar |
|---|---|---|
| Instalación y descarga | Obtienes Ollama y los archivos del modelo desde sus servicios | Conexión, origen oficial, espacio y licencia de la variante |
| Inferencia local | El modelo seleccionado genera una respuesta en el equipo | Que el selector indique el modelo local esperado |
| Extensiones adicionales | Pueden aportar contexto, comandos u otros servicios | Permisos, destinos de red, almacenamiento y política de tu organización |
| Modelo cloud | La petición se procesa en infraestructura remota | Condiciones, cuenta y datos enviados al proveedor |
No uses datos personales, secretos, código de clientes ni credenciales para hacer la primera prueba. Empieza con un fragmento inventado y determina con el equipo de seguridad qué información se puede tratar. La guía sobre DeepSeek en local explica la ejecución desde terminal; aquí nos centramos en la conexión al editor.
Requisitos y elección de modelo
La integración oficial de Ollama indica como requisitos Visual Studio Code 1.127 o posterior, Ollama instalado y en ejecución, y al menos un modelo local o cloud disponible. La documentación avisa de que versiones anteriores de VS Code no cancelan de forma fiable algunas peticiones de proveedores de modelos. Comprueba la versión instalada antes de investigar un problema que pueda ser simplemente de compatibilidad.
El tamaño del modelo no es una recomendación universal de memoria. Un modelo pequeño suele ser una prueba más razonable en un equipo limitado, pero el consumo real también depende del contexto, la cuantización, el sistema operativo y las aplicaciones abiertas. La biblioteca de Ollama, por ejemplo, publica la familia Qwen2.5-Coder con variantes etiquetadas por tamaño, como 0.5b, 1.5b, 3b, 7b, 14b y 32b. Comprueba las etiquetas, tamaños descargables y licencia que figuren en la página al elegir; pueden cambiar.
Como primera evaluación, selecciona una variante pequeña que aparezca en la biblioteca y que tu equipo pueda manejar, sin asumir que una cifra de parámetros predice por sí sola la calidad para tu lenguaje o tarea. Si tarda demasiado o agota memoria, prueba una variante menor o cierra procesos que no necesites. Si responde bien a una función corta, eso no garantiza que gestione de manera fiable un proyecto completo.
Instalar Ollama y descargar un modelo
- Descarga el instalador para tu sistema operativo desde la página oficial de Ollama y sigue las instrucciones que aparecen allí para macOS, Windows o Linux. Los pasos pueden ser distintos según plataforma; no ejecutes comandos de instalación copiados de una guía para otro sistema.
- Abre Ollama y comprueba que está en ejecución. La guía de VS Code indica que la extensión descubre modelos desde
http://127.0.0.1:11434de forma predeterminada. - Elige una etiqueta disponible en la biblioteca oficial de modelos. Descárgala según las instrucciones actuales de Ollama. Para una prueba basada en terminal, la documentación incluye
ollama pullseguido del nombre del modelo; usa exactamente la etiqueta mostrada en su ficha, no una inventada ni una etiqueta cloud si quieres inferencia local. - Espera a que termine la descarga. Revisa el espacio libre y evita interrumpirla; la descarga inicial necesita internet. Guarda el nombre exacto de la etiqueta para poder reproducir la prueba.
La biblioteca y las condiciones de licencia dependen del modelo concreto. Que Ollama catalogue un modelo no significa que todos tengan la misma licencia o que sus usos comerciales sean idénticos. Lee la ficha del modelo y las condiciones aplicables antes de incorporarlo a un producto o redistribuirlo.
Conectar Ollama a VS Code
La ruta descrita por la documentación de Ollama es usar su extensión oficial para el chat de VS Code:
- Instala la extensión Ollama desde Visual Studio Code Marketplace. Revisa que el editor tenga la versión requerida.
- Abre la vista Chat de VS Code.
- Abre el selector de modelos en la parte inferior del cuadro de chat.
- En la sección Ollama, elige el modelo que descargaste. Comprueba el nombre seleccionado antes de escribir el prompt.
- Envía una instrucción inocua sobre código ficticio y verifica que aparece una respuesta.
La integración descubre modelos del servicio local por defecto en la dirección local indicada arriba. No es necesario inventar una URL personalizada ni modificar ajustes sin motivo para completar este flujo básico. Si el modelo no aparece, comprueba primero que Ollama está abierto y que la descarga acabó; después usa las opciones de diagnóstico que ofrece la extensión.
Prueba reproducible: crea una función de ejemplo sin datos ni código del trabajo, por ejemplo una función que reciba una lista de precios ficticios y devuelva el total. Pide al asistente: “Explica qué hace esta función y señala dos casos límite que debería probar. No cambies el código”. Comprueba la explicación leyendo tú mismo el fragmento y añade manualmente casos sencillos, como una lista vacía y una lista con un único precio. El objetivo es probar la conexión y evaluar una respuesta, no delegar una decisión ni ejecutar cambios a ciegas.
Revisa el resultado antes de aceptar código
Un modelo puede producir código que parece correcto y contener errores, asumir una biblioteca que no existe o ignorar una condición límite. En una prueba pequeña:
- Pide primero una explicación o una propuesta, no permiso para editar todo el proyecto.
- Compara la respuesta con lo que hace realmente la función y confirma cada afirmación.
- Si aceptas un cambio, inspecciona el diff antes de guardarlo y ejecútalo en un entorno de prueba.
- Ejecuta las pruebas existentes y añade un caso límite relevante; el asistente no sustituye la revisión ni las pruebas.
- No pegues tokens, claves, nombres de clientes ni ficheros internos para “dar más contexto”.
VS Code y Ollama pueden evolucionar. Si tu editor muestra controles diferentes, consulta la documentación actual enlazada y comprueba la versión, en lugar de copiar capturas o nombres de opciones de una versión antigua.
Cómo comprobar conexiones y resolver fallos
Haz estas comprobaciones en orden, sin usar un repositorio confidencial:
- Confirma que Ollama está en ejecución y que el modelo terminó de descargarse. La documentación propone
ollama listpara revisar los modelos disponibles. - En el selector de VS Code, verifica que elegiste una opción de la sección Ollama y no una opción cloud u otro proveedor.
- Si el modelo no aparece, abre la paleta de comandos y ejecuta Ollama: Refresh Models. Si sigue sin estar disponible, la extensión documenta Ollama: Diagnose Models y el canal de salida Ollama para revisar el diagnóstico.
- Para distinguir inferencia local de conectividad general, realiza una prueba con datos ficticios, espera a que la descarga haya terminado y desconecta temporalmente internet. Si la respuesta local continúa, confirma que esa ruta concreta funciona sin red; no demuestra que todas las extensiones estén aisladas ni que no existan otros accesos.
- Si falla, vuelve a conectar la red y confirma versiones compatibles, nombre de modelo, estado del servicio y espacio disponible. Actualiza solo desde las páginas oficiales y repite la prueba.
La extensión es solo una parte del flujo: otras extensiones del editor, sincronización de ajustes, terminales remotos, copias de seguridad o herramientas de desarrollo pueden tener sus propios destinos de red. Consulta la configuración y política de tu organización. Una respuesta sin conexión es una comprobación acotada, no una auditoría de seguridad completa.
Límites, privacidad y alternativa cloud
Trabajar con un modelo local puede reducir qué información recibe el proveedor del modelo durante esa inferencia, pero no garantiza por sí solo que el código nunca salga del equipo. El equipo puede sincronizar archivos, una extensión distinta puede enviar contexto, y el soporte remoto, telemetría o copias de seguridad tienen flujos propios. Revisa lo que está instalado y autorizado, no solo el nombre del modelo.
Los modelos locales también dependen de la capacidad del ordenador y pueden ser más lentos o menos eficaces en ciertas tareas que un servicio cloud. A cambio, puedes probar una inferencia local sin enviar el prompt al proveedor del modelo, siempre que confirmes la selección y el flujo. Si usas un modelo cloud, sus requisitos de cuenta, red y condiciones son diferentes; no lo describas como una solución “sin nube”.
Si el código pertenece a un empleador o cliente, sigue las normas de seguridad, licencias y uso de software de tu organización antes de instalar extensiones o procesarlo con cualquier IA. Para adquirir criterio al aplicar IA a tareas profesionales, consulta el curso práctico de IA para Marketing; no sustituye una formación específica de programación ni las políticas de seguridad de tu empresa.
Preguntas frecuentes
¿Necesito una GPU para usar Ollama en VS Code?
No necesariamente para probar cualquier modelo, pero tampoco se puede prometer que todos funcionen con fluidez en todos los equipos. Depende de la variante, la memoria, la plataforma y los recursos disponibles. Consulta la ficha y empieza con una opción pequeña.
¿Funciona sin conexión después de descargar el modelo?
La inferencia de un modelo local descargado puede funcionar sin conexión. La instalación, descarga y actualización requieren internet; algunas funciones o extensiones también pueden depender de servicios remotos. Compruébalo con una consulta ficticia y verifica el modelo seleccionado.
¿Mi código sale del equipo?
Si seleccionas un modelo local, la inferencia se procesa en tu equipo, pero no es suficiente para afirmar que todo el editor y sus extensiones están aislados. Comprueba el modelo, las integraciones, la sincronización y las políticas aplicables antes de usar información de trabajo.
¿Qué modelo cabe en mi ordenador?
No hay una respuesta única: influyen tamaño, cuantización, contexto, memoria y otros procesos. Consulta las etiquetas y requisitos publicados en la biblioteca oficial, prueba una variante pequeña y mide el resultado en tu equipo.
Una buena primera decisión es simple: confirma versiones, descarga una variante pequeña desde la biblioteca oficial, conéctala desde la extensión de Ollama y evalúala con una función inventada. Solo después de revisar la respuesta, las conexiones y las reglas de tu organización podrás decidir si la IA local encaja en una tarea real.
Sigue leyendo en humAIns