Usar Ollama como agente de programación

Inicia Ollama, descarga un modelo que llame a herramientas y ejecuta oharness -m ollama/<model>. El proveedor ollama viene incorporado en localhost:11434, sin clave, y OHarness descubre todos los modelos que hayas descargado.

Tres comandos

$npm install -g oharness

$ollama pull qwen3-coder:30b

$oharness -m ollama/qwen3-coder:30b

Primero, amplía la ventana de contexto

Es la trampa en la que cae casi todo el mundo. Si no se le indica otra cosa, Ollama sirve un contexto mucho más corto del que admiten la mayoría de los modelos, y un agente lo llena enseguida con contenidos de archivos y resultados de herramientas. Cuando el servidor no informa de su ventana, OHarness supone 128K, así que el servidor trunca antes de que el harness compacte. Inicia Ollama con una ventana real:

$OLLAMA_CONTEXT_LENGTH=32768 ollama serve

Qué modelo

Uno que admita llamada a herramientas, de 20–30B parámetros o más para trabajo real de agente: modelos ajustados para código como Qwen3-Coder, o generalistas como gpt-oss. Los modelos más pequeños responden bien a preguntas, pero pierden el hilo en ediciones de varios pasos. Todo lo que hayas descargado aparece en /models.

Conviene saber

Ollama en otra máquina: sobrescribe el baseUrl del proveedor en ~/.oharness/config.json (formato más abajo).
Los modelos locales y los alojados comparten sesión: lee con Ollama y luego usa /model para pasar a un modelo alojado en un paso difícil.
Trabajar totalmente sin conexión enumera el poco tráfico de red que queda y cómo desactivarlo.

Preguntas frecuentes

¿Puedo usar Ollama con un agente de programación como Claude Code?

Sí. OHarness incluye Ollama como proveedor incorporado: inicia Ollama, descarga un modelo con llamada a herramientas y ejecuta oharness -m ollama/<model>. No hace falta clave ni archivo de configuración.

¿Por qué mi agente de programación con Ollama olvida lo que hizo antes?

La ventana de contexto predeterminada de Ollama es mucho más pequeña que la del modelo. Fija OLLAMA_CONTEXT_LENGTH (o num_ctx) en 32K o más para que sea la compactación del agente, y no el truncado del servidor, la que decida qué se resume.

¿Qué modelos de Ollama admiten llamada a herramientas?

Ollama marca en su biblioteca los modelos capaces de usar herramientas con la etiqueta tools. Qwen3-Coder y gpt-oss son opciones habituales para agentes de programación.

Referencia de Ollama

Id del proveedor	`ollama`
URL base	`http://localhost:11434/v1`
Protocolo	Chat completions compatible con OpenAI
Clave API	Ninguna: el endpoint es local.
Descubrimiento de modelos	Sí: la lista de modelos se le pide al endpoint en lugar de venir en el paquete.

Cómo conectarlo

Nada que configurar y ninguna clave que conseguir. Inicia el servidor en su puerto habitual y el proveedor aparece en el selector de modelos; el harness le pide su propia lista de modelos en lugar de traer una en el paquete.

Apuntarlo a otro sitio

Un host regional, un gateway o un servidor propio. Las sobrescrituras en ~/.oharness/config.json son por campo, así que cambiar el endpoint no obliga a repetir el resto del proveedor. Este es el bloque completo, con el valor predeterminado para que se vea la forma:

{
  "providers": {
    "ollama": {
      "baseUrl": "http://localhost:11434/v1"
    }
  }
}

Lo que obtienes en cualquier caso

El mismo bucle del agente, las mismas herramientas, los mismos servidores MCP y las mismas reglas de permisos, sea cual sea el proveedor de debajo; y cambiar entre ellos a mitad de sesión no convierte nada, porque el historial nunca se guarda en el formato de un proveedor. Qué es un harness de agentes explica por qué esa es la parte difícil, y la referencia de proveedores cubre el propio catálogo.

Los 34 proveedores · Instalar OHarness