Agente de terminal local · endpoint de Ollama · herramientas del repositorio
La ruta rápida usa un solo comando. Una instalación fiable también necesita un modelo compatible con herramientas, al menos 64K de contexto, memoria suficiente y un entorno Git seguro.
Ruta oficial más corta
Instala ambas aplicaciones desde sus fuentes oficiales, verifica que Ollama esté activo y ejecuta:
ollama launch opencodeOllama permite elegir un modelo disponible e inicia OpenCode con una configuración local en línea sin sobrescribir la configuración permanente.
La comprobación que evita falsos comienzos
La integración oficial de Ollama exige 64K o más para OpenCode. Fragmentos del repositorio, herramientas, salidas e historial ocupan ese espacio.
Instalación reproducible
Descarga Ollama y sigue la guía de OpenCode para tu sistema.
Comprueba seguimiento de instrucciones, function calling y contexto en la ficha. Un modelo de autocompletado no siempre es buen agente.
Ejecuta ollama list y usa exactamente el nombre y la etiqueta mostrados.
Usa ollama launch opencode. La opción --config prepara la configuración sin abrir una sesión.
Haz que lea un archivo, aplique un cambio reversible y ejecute una prueba inocua. Una buena conversación no demuestra tool calls.
Observa memoria, espera inicial, velocidad y pruebas. Reduce contexto si falta memoria; cambia de modelo si los parches rápidos son incorrectos.
Configuración manual
En opencode.json, sustituye el ID por el valor de ollama list.
{ "$schema": "https://opencode.ai/config.json", "provider": { "ollama": { "npm": "@ai-sdk/openai-compatible", "name": "Ollama (local)", "options": { "baseURL": "http://localhost:11434/v1" }, "models": { "id-del-modelo": { "name": "Mi modelo de código local" } } } } }Endpoint local
localhost:11434/v1 apunta a Ollama en este PC. No publiques el endpoint solo para conectar rápidamente otro dispositivo.
Modelo + 64K + margen
Modelo, cuantización, caché KV y sesiones determinan la clase del PC.
| Clase de modelo | Inicio práctico | Uso | Comprobación |
|---|---|---|---|
| 7B–14B cuantizado | 12–16 GB VRAM, 32 GB RAM | Chat centrado y primeras pruebas | 64K y herramientas deben funcionar juntos. |
| 20B–24B cuantizado | 24 GB VRAM, 64 GB RAM | Agente único más capaz | Reserva margen para caché y compilación. |
| 30B–32B cuantizado | 32 GB VRAM o 64 GB+ unificados | Agente de repositorio más fuerte | Lo que cabe a 32K puede ser justo a 64K. |
| Modelo grande o varios agentes | 96–128 GB unificados/coherentes | Capacidad y varios servicios | Valida runtime y espera otro perfil de velocidad. |
Son rangos con margen, no garantías. Usa el buscador de PC con archivo de modelo y contexto.
Diagnóstico por síntoma
| Síntoma | Causa probable | Acción |
|---|---|---|
| Modelo ausente | Servicio parado o etiqueta errónea | Comprueba ollama list y el ID exacto. |
| Chat sí, edición no | Tool calling insuficiente | Prueba un modelo de código con herramientas documentadas. |
| Memoria llena después | Caché de contexto o sesiones | Cierra sesiones, reduce contexto o cuantización. |
| Espera larga al inicio | Prompt largo, offload CPU o carga fría | Comprueba offload y elimina contexto innecesario. |
| Endpoint inaccesible | Host, puerto o servicio incorrecto | Restaura http://localhost:11434/v1. |
Local no significa sin riesgo
Rama o worktree limpio con vuelta sencilla.
Sin secretos ni volcados de producción accesibles.
Rechaza acciones destructivas o privilegiadas que no entiendas.
Diff, pruebas, lint y seguridad antes del merge.
Referencias oficiales
Inicio, contexto 64K y configuración en la guía oficial.
Sintaxis y endpoint local en la documentación oficial.
Arquitectura, contexto y herramientas en la ficha oficial.
Compara velocidad y capacidad en la guía de programación local.
¿Aún eliges PC?
El buscador separa velocidad de VRAM dedicada y capacidad de memoria compartida.