Intermedio 10 minIDE

Zed + Ollama: el editor ultrarrápido con asistente local

Respuesta directa

Sí, Zed se conecta nativamente a Ollama : instalar Ollama, hacer ollama pull d un modelo, verificar que el servidor esté funcionando, luego elegir este modelo en el menú desplegable, que Zed rellena automáticamente. Un ajuste que hay que conocer antes de usarlo: por defecto, Zed envía una ventana de contexto de solo 4096 tokens a Ollama, mucho por debajo de la mayoría de los modelos recientes, lo cual explica respuestas truncadas en un archivo grande.

Zed es un editor de código multiusuario escrito en Rust, conocido por su rapidez de respuesta. Esta guía cubre su configuración con Ollama para el asistente de IA local, el ajuste de la ventana de contexto, la detección automática de modelos y los mecanismos de permisos y aislamiento que delimitan lo que el agente de Zed puede hacer en tu máquina.

Por Mohamed Meguedmi·Actualización 2026-09-28·Probado en Windows, macOS y Linux

#Configurar Ollama en Zed

La documentación oficial de Zed describe un procedimiento en cuatro pasos: descargar e instalar Ollama, descargar un modelo, comprobar que el servidor de Ollama esté funcionando y, después, seleccionar ese modelo en el menú desplegable de Zed.

Terminal
ollama pull mistral
ollama serve

En macOS, ejecutar la aplicación Ollama.app es suficiente para arrancar el servidor; en Linux o desde una terminal, el comando ollama serve hace lo mismo. Zed es presentado por su editor como un editor de código multiusuario y de alto rendimiento, creado por los autores de Atom y Tree-sitter; la última versión estable el 28 de septiembre de 2026 es v1.21.0, publicada el 23 de septiembre de 2026, y el repositorio contaba con cerca de 91.000 estrellas en GitHub en esa fecha.

Esta configuración de Ollama permite utilizar todas las funciones de IA de Zed que se basan en un modelo de lenguaje: el panel Agent para tareas que abarcan varios archivos, el asistente integrado en el editor (Inline Assistant) para modificaciones específicas y los hilos de terminal que permiten al agente proponer comandos. Los agentes externos y los hilos de terminal pueden requerir, sin embargo, su propia configuración de modelo local, separada de la descrita aquí para las funciones nativas de Zed.

#Detección automática de modelos

El kit Copiloto Local

Esta guía te lleva al modelo. El kit te lleva al copiloto que programa en tu editor.

  • Espacio en línea de por vida
  • PDF + archivos
  • Reembolsado 30 j

Zed detecta automáticamente los modelos que ya ha descargado Ollama y los propone en el menú de selección. Para desactivar esta detección y listar manualmente los modelos con sus capacidades precisas, hay que establecer auto_discover en false en los ajustes.

settings.json
{
  "language_models": {
    "ollama": {
      "api_url": "http://localhost:11434",
      "auto_discover": false,
      "available_models": [
        {
          "name": "qwen2.5-coder",
          "display_name": "qwen 2.5 coder",
          "max_tokens": 32768,
          "supports_tools": true,
          "supports_thinking": true,
          "supports_images": true
        }
      ]
    }
  }
}

Este modo manual tiene una utilidad práctica: forzar supports_tools o max_tokens para un modelo que Zed no clasificaría correctamente de forma automática, o documentar en el archivo de configuración versionado del proyecto qué modelo se supone que debe usar el equipo.

El campo supports_tools merece especial atención: indica a Zed si el modelo puede recibir definiciones de herramientas en el agente de Zed (edición de archivos, ejecución de comandos) en lugar de quedar limitado a un simple chat. Un modelo de Ollama sin capacidad declarada de llamada a herramientas funcionará para el asistente integrado en el código o el autocompletado, pero no para las tareas que abarcan varios archivos del panel Agent.

#Ventana de contexto de 4096 tokens

Zed transmite la longitud de contexto a Ollama mediante el parámetro num_ctx, con 4096 tokens por defecto según la documentación oficial. Es claramente inferior a la ventana nativa de la mayoría de los modelos recientes (frecuentemente 32 000 tokens o más), y un archivo de tamaño medio puede ser suficiente para superar este límite.

!
Gradiente de sorpresa
No es un límite del modelo, sino un ajuste predeterminado de Zed mismo. Un modelo anunciado con un contexto de 128k tokens responderá de forma truncada en un archivo grande si Zed continúa enviando num_ctx=4096 sin que este se corrija en los ajustes.
Identificar el contexto
{
  "language_models": {
    "ollama": {
      "context_window": 8192
    }
  }
}

Este ajuste de context_window se aplica a todos los modelos Ollama configurados en Zed; un contexto diferente por modelo se define mediante max_tokens en available_models, desactivando auto_discover para que el valor se tome en cuenta.

#llama.cpp y LM Studio, alternativas locales

Zed soporta llama.cpp al mismo nivel que Ollama, con detección automática de modelos servidos en modo enrutador, refinada por un flujo /models/sse que exige una versión reciente del servidor llama.cpp. LM Studio también está soportado a través de su servidor API local, iniciado con lms server start.

Comparar las tres vías locales en Zed
BackendDescubrimiento de modelosParticularidad
OllamaAutomático (modelos ya descargados)Contexto que se debe configurar manualmente (4096 por defecto)
llama.cppAutomático en modo enrutador (requiere versión reciente)Carga bajo demanda con la opción -hf
LM StudioManual a través de la lista de modelos cargadosInterfaz gráfica de gestión de modelos además de la API

#Permisos de las herramientas del agente

Desde la versión 0.224.0, la aprobación de las herramientas del agente Zed se configura mediante agent.tool_permissions.default; antes de esta versión, un simple valor booleano (agent.always_allow_tool_actions, false por defecto) controlaba el conjunto. El nuevo sistema permite reglas basadas en patrones regex, con tres resultados posibles: autorizar, rechazar o pedir siempre confirmación.

settings.json — reglas por herramienta
{
  "agent": {
    "tool_permissions": {
      "default": "allow",
      "tools": {
        "terminal": {
          "default": "confirm",
          "always_allow": [
            { "pattern": "^cargo\\s+(build|test|check)" }
          ],
          "always_confirm": [{ "pattern": "sudo\\s+/" }]
        }
      }
    }
  }
}

Este ejemplo, extraído de la documentación oficial, autoriza automáticamente comandos cargo específicos en la herramienta de terminal, mientras exige siempre una confirmación para cualquier comando sudo que afecte a la raíz del sistema: un nivel de granularidad útil cuando el modelo conectado es un pequeño modelo local menos predecible que un modelo de referencia en la nube.

#El sandbox: lo que realmente protege

Más allá de los permisos declarativos, Zed ofrece un entorno aislado a nivel del sistema operativo para las llamadas a herramientas de su agente. La documentación precisa su alcance: se aplica únicamente a las herramientas terminal y fetch, no a Zed en sí, ni a los servidores de lenguaje, las extensiones, las tareas o las pestañas de terminal convencionales.

Herramienta de terminal
El entorno aislado limita las escrituras en disco y el acceso saliente a la red de los comandos ejecutados por el agente; los metadatos de Git están protegidos.
Herramienta fetch
El entorno aislado restringe los hosts con los que el agente puede comunicarse efectivamente.
Requisitos de Linux
Debe estar presente en el PATH un binario bwrap ejecutable y no setuid.
Requisitos para Windows
WSL debe estar disponible; la documentación precisa que el aislamiento del entorno de ejecución es más débil en WSL que en Linux o macOS y puede no bloquear todos los intentos de escape.
i
Los permisos y el entorno aislado se complementan
Los permisos por patrón limitan la capacidad del agente para iniciar una acción; el entorno aislado, una vez iniciada la acción, limita lo que esta puede afectar realmente en el sistema. Ninguno de los dos mecanismos sustituye al otro.

Es importante tener en cuenta este alcance limitado (solo terminal y fetch) antes de confiar tareas sensibles a un pequeño modelo local menos predecible: las modificaciones de archivos realizadas mediante edit_file o write_file están sujetas a los permisos declarativos y a los perfiles de agente, no al aislamiento del sistema que proporciona el sandbox. Por tanto, una revisión humana sigue siendo útil para estas acciones, incluso con el sandbox activo para el resto.

#Servidores MCP en Zed

Además de usar Ollama como proveedor de modelos, Zed utiliza Model Context Protocol para interactuar con servidores de contexto externos: bases de datos, gestores de tickets y documentación empresarial. La documentación oficial precisa que Zed admite las funciones Herramientas y Prompts de MCP, lo que proporciona al agente capacidades adicionales a las de las herramientas integradas (edición de archivos, terminal).

Para garantizar que se utilice realmente un servidor MCP concreto sin que compita con las herramientas integradas de Zed, la documentación muestra un perfil de agente dedicado (con el servidor container-use como ejemplo) que desactiva las herramientas integradas y solo activa las del servidor MCP elegido, con enable_all_context_servers establecido en false en la configuración del perfil.

settings.json — fragmento del perfil MCP oficial
{
  "enable_all_context_servers": false,
  "context_servers": {
    "container-use": {
      "tools": {
        "environment_create": true,
        "environment_add_service": true,
        "environment_update": true,
        "environment_run_cmd": true
      }
    }
  }
}

Esta granularidad por perfil encaja con el sistema de permisos por herramienta descrito más arriba: con un modelo Ollama local menos predecible que un modelo de referencia en la nube, limitar las herramientas que realmente se exponen al agente —ya procedan de un servidor MCP o de las capacidades nativas de Zed— reduce las posibilidades de error incluso antes de abordar la cuestión de los permisos y del entorno aislado.

#La edición predictiva (Zeta), también en local

Zed ofrece una función distinta del agente de chat: la edición predictiva, que sugiere el siguiente cambio mientras escribes y se acepta pulsando Tab. El proveedor predeterminado es Zeta, un modelo de código abierto desarrollado por el propio Zed, distinto de los modelos de conversación configurados para el panel Agent o el asistente inline.

Para mantener esta funcionalidad completamente local, la documentación oficial permite configurar un proveedor Ollama dedicado a la edición predictiva, con variantes del modelo previstas para este uso (zeta2 en particular), en lugar de reutilizar el modelo de chat ya configurado para el agente: ambos ajustes son independientes en Zed. Un modelo más pequeño, diseñado para predecir una sola modificación a la vez en lugar de mantener una conversación de múltiples turnos, suele responder más rápido que un modelo de chat generalista en esta tarea concreta, y eso importa más aquí que la capacidad de razonamiento pura: la latencia percibida al escribir es el criterio que prima, muy por delante de la riqueza de las respuestas.

→
Dos modelos, dos ajustes distintos
El modelo utilizado para la edición predictiva (Zeta o su equivalente en Ollama) y el utilizado para el agente de chat o el asistente inline se configuran por separado. Aumentar num_ctx para el agente, por ejemplo, no cambia en nada el comportamiento de la edición predictiva mientras no se ajuste su propio proveedor.

#Ollama en un servidor remoto

Si Ollama corre en otra máquina o requiere una clave (caso de Ollama Turbo, la versión alojada), la clave se introduce en la interfaz del proveedor o a través de la variable OLLAMA_API_KEY, y la URL de la API debe apuntar al endpoint remoto en lugar de localhost.

Este escenario remoto tiene una ventaja concreta para un equipo: un único servidor Ollama, dimensionado para un modelo de tamaño adecuado, puede dar servicio a varios equipos con Zed configurados con la misma URL de API, evitando que cada desarrollador tenga que ejecutar y recargar el modelo en su propia máquina. La ventana de contexto y las capacidades declaradas (supports_tools, supports_thinking) solo tendrán que configurarse una vez, en la configuración compartida del proyecto en lugar de en los ajustes personales de cada uno.

Preguntas frecuentes
¿Por qué Zed recorta las respuestas en un archivo grande con Ollama?+
Por defecto, Zed envía a Ollama una ventana de contexto de solo 4096 tokens (parámetro num_ctx), independientemente de la ventana nativa anunciada por el modelo. No es una limitación del modelo, sino un ajuste predeterminado del propio Zed. El ajuste context_window en los parámetros de Ollama de Zed permite aumentarla, por ejemplo a 8192 o más según la VRAM disponible.
¿Detecta Zed automáticamente mis modelos Ollama?+
Sí, por defecto, Zed detecta los modelos ya descargados por Ollama y los propone en el menú de selección. Para listar manualmente los modelos con sus capacidades precisas (soporte de herramientas, razonamiento, imágenes), debes desactivar auto_discover y declararlos manualmente en available_models, con un max_tokens propio para cada uno.
¿El sandbox de Zed protege todas las herramientas del agente?+
No. La documentación oficial especifica que se aplica únicamente a las herramientas terminal y fetch. Las demás herramientas, incluida la edición de archivos mediante edit_file o write_file, siguen regidas por los permisos declarativos y los perfiles de agente, sin aislamiento adicional del sistema; una revisión humana sigue siendo útil para estas acciones.
¿Se puede usar LM Studio o llama.cpp en lugar de Ollama en Zed?+
Sí, los tres están soportados nativamente para las funciones de IA de Zed. llama.cpp y Ollama ofrecen detección automática de modelos ya cargados; LM Studio requiere iniciar su propio servidor API local con el comando lms server start antes de que Zed pueda conectarse a él.
¿Es tan fiable el entorno aislado de Zed en Windows como en Linux?+
No, la documentación oficial lo indica explícitamente: el sandbox en Windows se basa en WSL y sigue siendo más débil que en Linux o macOS, donde se basa en bwrap; puede no impedir todos los intentos de escape en esta plataforma, algo que hay que tener en cuenta antes de confiarle una tarea sensible.
¿Puede Zed usar servidores MCP con un modelo Ollama local?+
Sí. Zed admite las funcionalidades Herramientas y Prompts del Model Context Protocol, independientemente del proveedor de modelos configurado, incluido Ollama. Un perfil de agente específico permite desactivar las herramientas integradas y exponer solo las de un servidor MCP concreto, lo que limita las posibilidades de error con un modelo local menos predecible.
¿Puede la edición predictiva de Zed funcionar íntegramente en local?+
Sí. El proveedor predeterminado, Zeta, es un modelo de código abierto desarrollado por Zed, pero la documentación oficial permite reemplazarlo por un modelo local de Ollama (variantes como zeta2 están previstas para este uso). Esta configuración es independiente del modelo usado para el agente de chat o el asistente en línea.

¿Esta guía te ha ayudado?

¿Un comentario, un error, una precisión? Avísanos, eso mejora la guía para todos.