Lokale terminalagent · Ollama-endpoint · repositorytools
De snelle route is één opdracht. Een betrouwbare installatie vraagt ook een model met werkende tools, minimaal 64K ingestelde context, genoeg geheugen en een veilige Git-werkmap.
Kortste officiële route
Installeer beide toepassingen via hun officiële bronnen, controleer dat Ollama draait en voer uit:
ollama launch opencodeOllama laat een aanwezig model kiezen en start OpenCode met een lokale inline-configuratie. De permanente OpenCode-configuratie wordt niet overschreven.
Controle tegen valse starts
De Ollama-integratie vraagt voor OpenCode om 64K of meer. Repositoryfragmenten, tools, opdrachtuitvoer en historie vullen deze ruimte.
Herhaalbare installatie
Download Ollama en volg de OpenCode-gids voor je systeem.
Controleer instruction following, function calling en context in de modelkaart. Een autocomplete-model is niet automatisch een goede agent.
Voer ollama list uit en gebruik exact de getoonde naam en tag.
Gebruik ollama launch opencode. Met --config wordt de configuratie voorbereid zonder direct een sessie te openen.
Laat één bestand lezen, een kleine omkeerbare wijziging maken en een veilige test uitvoeren. Goede chat bewijst geen tool calls.
Bekijk geheugen, begintijd, snelheid en testresultaat. Verlaag context bij geheugentekort; verander model als snelle patches fout zijn.
Handmatige configuratie
Vervang in opencode.json de ID door de waarde uit 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": { "jouw-model-id": { "name": "Mijn lokale codingmodel" } } } } }Lokaal endpoint
localhost:11434/v1 wijst naar Ollama op deze pc. Maak het endpoint niet openbaar alleen om snel een ander apparaat te verbinden.
Model + 64K + reserve
Model, kwantisatie, KV-cache en sessies bepalen de pc-klasse.
| Modelklasse | Praktische start | Gebruik | Controle |
|---|---|---|---|
| 7B–14B gekwantiseerd | 12–16 GB VRAM, 32 GB RAM | Gerichte chat en eerste tests | 64K en tools moeten samen passen. |
| 20B–24B gekwantiseerd | 24 GB VRAM, 64 GB RAM | Capabelere enkele agent | Reserveer ruimte voor cache en builds. |
| 30B–32B gekwantiseerd | 32 GB VRAM of 64 GB+ unified | Sterkere repository-agent | Wat bij 32K past kan bij 64K krap zijn. |
| Groot model of meerdere agents | 96–128 GB unified/coherent | Capaciteit en meerdere diensten | Controleer runtime en verwacht ander snelheidsgedrag. |
Dit zijn margerijke schattingen, geen garanties. Gebruik de pc-kiezer met modelbestand en gewenste context.
Diagnose per symptoom
| Symptoom | Waarschijnlijke oorzaak | Actie |
|---|---|---|
| Model ontbreekt | Dienst uit of verkeerde tag | Controleer ollama list en de exacte ID. |
| Chat werkt, edit niet | Onvoldoende tool calling | Test een codingmodel met gedocumenteerde tools. |
| Geheugen raakt later vol | Contextcache of sessies | Sluit sessies, verlaag context of kies kleinere kwantisatie. |
| Lange tijd tot eerste token | Lange prompt, CPU-offload of koude start | Controleer offload en verwijder overbodige context. |
| Endpoint onbereikbaar | Verkeerde host, poort of dienst | Herstel http://localhost:11434/v1. |
Lokaal betekent niet risicoloos
Schone branch of worktree met eenvoudige terugweg.
Geen geheimen of productiedumps toegankelijk.
Weiger onbegrepen destructieve of beheerdersacties.
Diff, tests, lint en beveiliging vóór merge.
Officiële bronnen
Start, 64K-context en configuratie in de officiële gids.
Syntax en lokaal endpoint in de officiële documentatie.
Architectuur, context en tools in de officiële modelkaart.
Vergelijk snelheid en capaciteit in de lokale codinggids.
Pc nog kiezen?
De kiezer scheidt snelheid van losse VRAM en capaciteit van gedeeld geheugen.