OpenCode: installatie, modellen en de eerste keer opstarten

OpenCode is een open-source AI-codeeragent voor de terminal: de tool zelf is gratis (MIT-licentie) en je kunt elk model koppelen, van Claude en GPT tot een lokaal model via Ollama. De projectrepository heeft inmiddels meer dan tweehonderdduizend sterren op GitHub. De uitdrukking “gratis Claude Code met elk model” klinkt aantrekkelijk, maar vraagt om verduidelijking: de tool is gratis; de gebruiksvoorwaarden hangen af van het model dat je kiest.

Hieronder vind je alles volgens de officiële documentatie: wat de tool is, hoe je hem installeert op macOS, Linux of Windows, hoe je een model koppelt en wat je bij de eerste keer opstarten doet. Er is een apart gedeelte over de kosten, want “gratis” geldt hier alleen voor de tool: modellen kosten geld, en dat leidt vaak tot verwarring.

Praktische informatie over werken met Ailoot staat in de documentatie.

Wat is OpenCode in eenvoudige bewoordingen?#

Kort gezegd doet OpenCode hetzelfde als Claude Code: het neemt een opdracht in gewone taal aan en voert die uit in je project. Op twee punten verschillen ze. De code is volledig open, zodat je die kunt lezen en inspecteren. En de tool is niet gebonden aan één modelprovider: hij werkt met meer dan 75 providers, van Anthropic en OpenAI tot een lokaal model dat op je eigen hardware draait.

Het project wordt ontwikkeld door het Anomaly-team. De repository is aangemaakt op 30 april 2025 en heeft op 4 oktober 2026 meer dan 211 duizend sterren en 28 duizend forks (geverifieerd met een GitHub API-verzoek). De programmeertaal is TypeScript. De documentatie wordt voortdurend bijgewerkt, dus de onderstaande instructies zijn gebaseerd op de huidige versie.

Haal de namen niet door elkaar: het npm-pakket voor de huidige lijn heet opencode-ai, de repository heet anomalyco/opencode en de terminalopdracht is simpelweg opencode. In oudere artikelen kun je het adres sst/opencode tegenkomen: de organisatie heeft haar naam veranderd en de oude link verwijst nu door naar de nieuwe.

Bijgewerkt op 4 oktober 2026: het team heeft OpenCode 2.0 uitgebracht, de volgende grote generatie van de tool. De onderstaande instructies voor installatie en het koppelen van een model zijn nog steeds geschreven voor de huidige 1.x-lijn (geïnstalleerd met de opdracht curl -fsSL https://opencode.ai/install | bash; de huidige versie op 30 september 2026 is 1.18.34): deze wordt actief ondersteund en is de versie die de officiële documentatie op opencode.ai/docs installeert. Wat er precies is veranderd in de tweede versie en wanneer je moet overstappen, wordt verderop in een apart gedeelte besproken.

Waarin verschilt OpenCode van Claude Code en Codex?#

Als je al een Claude-abonnement hebt, is het logisch om Claude Code als je belangrijkste tool te blijven gebruiken — we hebben er een uitgebreide installatiehandleiding voor. OpenCode is nuttig in drie gevallen: je wilt werken via een ChatGPT Plus- of GitHub Copilot-abonnement, je wilt een lokaal model draaien zonder API-kosten, of je wilt één interface voor meerdere modellen. We hebben ook een bespreking en installatiehandleiding voor Codex.

Als je nog een tool kiest, begin dan met dit overzicht: waar mensen in 2026 mee programmeren. Als OpenCode al is geïnstalleerd en je het via ACP wilt verbinden met andere agents in Devin Desktop, bekijk dan onze handleiding voor die configuratie.

Wat is er veranderd in OpenCode 2.0?#

De tweede versie installeer je met de opdracht curl -fsSL https://opencode.ai/v2/install | bash. Volgens de officiële migratiehandleiding (opencode.ai/v2/docs/migrate-v1) gebruiken beide versies dezelfde opdracht opencode en worden ze standaard niet meer naast elkaar geïnstalleerd: de v2-installer vervangt het v1-binaire bestand en voordat je v2 via een pakketbeheerder installeert, vraagt de documentatie uitdrukkelijk om eerst versie v1 te verwijderen. De configuratie wordt echter uit dezelfde bestanden gelezen — ~/.config/opencode/ en <project>/.opencode/ — zodat instellingen, agents en MCP-servers zonder herschrijven kunnen worden overgezet. Drie dingen moeten wel worden herschreven: plugins (die een nieuwe API hebben), integraties met de server-API (het protocol is veranderd) en terminalinstellingen (nu één gedeeld bestand cli.json in plaats van meerdere bestanden tui.json).

De twee opvallendste nieuwe functies in v2 zijn deze. Ten eerste is Console geïntroduceerd: een betaalde dienst voor teams met gebruiksregistratie, budgetten en gedeelde beleidsregels voor alle leden. Ten tweede heeft het team eindelijk de prijs van het Go-abonnement bekendgemaakt: $10 per maand voor Go en $40 per maand voor Go Plus met hogere limieten (de pagina opencode.ai/go, gecontroleerd op 4 oktober 2026). Eerder stond in de documentatie alleen “voordelig abonnement”, zonder bedrag.

Ben je nieuw en wil je de agent gewoon installeren, volg dan de onderstaande instructies; ze behandelen de huidige eerste versie die de documentatie zelf aanbeveelt. Overweeg v2 als je de nieuwe pluginfuncties of Console voor teams nodig hebt, maar houd er rekening mee dat je sommige oudere plugins voor de nieuwe API moet herschrijven. Ben je meer geïnteresseerd in een open-source desktopapp die geen terminal vereist, bekijk dan onze bespreking van ZCode, een vergelijkbare agent met een eigen interface.

Wat heb je nodig voordat je installeert?#

Iets meer over de terminal, want dat is de enige plek waar de installatie niet volgens plan kan verlopen. OpenCode rendert een volledige interface met panelen en markeringen in de terminal. Daarom vraagt de documentatie om een moderne emulator. Ziet de interface er na het opstarten verkeerd uit, installeer dan eerst een van de vier genoemde opties: WezTerm (werkt op alle systemen), Alacritty, Ghostty of Kitty. Op Windows is de belangrijkste route via WSL; daar staat verderop een apart gedeelte over.

Het tweede vereiste is een model. OpenCode werkt via het model dat je koppelt: uit zichzelf verwerkt het geen verzoeken. Er zijn vier opties: een abonnement (ChatGPT Plus, GitHub Copilot, GitLab Duo), een API-sleutel van een provider, OpenCode Zen, de aggregator van het team zelf, of een lokaal model via Ollama. Alle vier opties komen aan bod in het gedeelte over het koppelen van een model.

Zonder projectbeschrijving moet de agent de buildopdrachten, bestandsstructuur en gebruikte conventies raden — dat leidt tot “hallucinaties”. OpenCode gebruikt hiervoor een AGENTS.md-bestand. Dezelfde aanpak geldt voor Claude Code en elke andere agent; alleen de naam van het instructiebestand verandert.

Hoe installeer je OpenCode op macOS en Linux?#

De aanbevolen route is de officiële installer:

1. Voer de installer uit

   curl -fsSL https://opencode.ai/install | bash
   

   Het script detecteert je systeem en downloadt OpenCode. Wordt de opdracht na de installatie niet gevonden, sluit de terminal dan af en open hem opnieuw; in de nieuwe sessie wordt het pad opgepikt.

2. Controleer of de installatie is gelukt

   opencode --version
   

   De opdracht geeft een versienummer terug, wat betekent dat de installatie is gelukt. De melding “command not found” brengt je terug naar de eerste stap: start een nieuwe terminalsessie of pas PATH handmatig aan.

Als je liever zelf je pakketten beheert, zijn dit de mogelijkheden:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

De Homebrew-opdracht begint bewust met anomalyco/tap/: de documentatie raadt hun eigen tap aan, omdat het Homebrew-team de formule voor brew install opencode minder vaak bijwerkt. Dezelfde pakketnaam, opencode-ai, werkt ook met bun, pnpm en yarn (bun install -g opencode-ai, yarn global add opencode-ai). Gebruik op Arch Linux sudo pacman -S opencode uit de stabiele repository of paru -S opencode-bin voor de nieuwste versie uit AUR.

Werk OpenCode bij met opencode upgrade; bij het starten downloadt het ook zelf updates als automatisch bijwerken is ingeschakeld. Controleer na het bijwerken de versie met de bekende opdracht opencode --version. Verwijderen is ook ingebouwd:

opencode uninstall

De opdracht toont precies wat er wordt verwijderd en vraagt om bevestiging. Je kunt configuratie en sessiegegevens behouden als je wilt: gebruik de vlaggen --keep-config en --keep-data.

Hoe installeer je OpenCode op Windows?#

De eerste optie, die de ontwikkelaars zelf aanbevelen, is WSL. Installeer het met één opdracht in PowerShell dat als administrator draait:

wsl --install

Open na het opnieuw opstarten Ubuntu via het Startmenu en voer daarin de gebruikelijke opdracht uit:

curl -fsSL https://opencode.ai/install | bash

Je bestanden op Windows-schijven zijn in WSL beschikbaar via /mnt/: schijf C: staat op /mnt/c/ en schijf D: op /mnt/d/. Een project op C:\Users\Name\project open je dus als volgt:

cd /mnt/c/Users/Name/project
opencode

De tweede optie is WSL overslaan en Windows-pakketbeheerders gebruiken. In PowerShell:

choco install opencode

scoop install opencode

De derde optie is de desktopapp en de webversie. De app installeert als een normaal programma en toont de interface in een venster, zonder terminal. De webversie start met de opdracht opencode web: daarmee wordt OpenCode geopend in een browser. De documentatie raadt ook hiervoor aan om hem vanuit WSL te starten, om problemen met bestandstoegang te voorkomen. De documentatie vermeldt daarnaast minder gangbare opties: mise, Docker en een kant-en-klaar binair bestand op de GitHub-releasespagina. Installatie via bun op Windows is nog in ontwikkeling; gebruik de npm-optie als bun je belangrijkste pakketbeheerder is.

Hoe koppel je een model aan OpenCode?#

OpenCode ondersteunt meer dan 75 providers via de AI SDK en Models.dev, plus lokale modellen. De meeste koppel je met de opdracht /connect in de interface; voor lokale modellen geef je ook het serveradres op in de configuratie. De opties verschillen in betaalmethode en vereisten voor je computer:

De documentatie raadt beginners aan te starten met OpenCode Zen. Het team heeft modellen geselecteerd die specifiek goed werken als agents en de combinaties met providers getest aan de hand van eigen taken.

Zo koppel je het: voer /connect in, kies OpenCode Zen, meld je aan en voeg betaling toe op opencode.ai/auth, haal een sleutel op en plak die in. Daarna toont /models de lijst met aanbevolen modellen. Op 4 oktober 2026 staan bijvoorbeeld GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 en Kimi K2.5 op de lijst. De documentatie waarschuwt eerlijk dat de lijst niet volledig is en snel veroudert, omdat er elke week nieuwe modellen verschijnen.

Abonnementen koppel je met dezelfde opdracht /connect: kies ChatGPT Plus of GitHub Copilot uit de lijst en meld je aan bij je account — extra configuratie is niet nodig.

Als je Anthropic kiest, biedt /connect twee opties: handmatig een API-sleutel invoeren of Claude Pro/Max kiezen en je via een browser aanmelden. Anthropic verbiedt echter plugins van derden voor het gebruik van een Claude Pro/Max-abonnement. Ingebouwde plugins van dit type zijn vanaf versie 1.3.0 uit OpenCode verwijderd. Kom je een ouder artikel tegen over “OpenCode via een Claude-abonnement”, dan gaat het over die verwijderde plugins, niet over officiële autorisatie. Abonnementen voor ChatGPT Plus, GitHub Copilot, GitLab Duo (aangeduid als experimenteel) en Atomic Chat werken zonder extra configuratie.

OpenCode slaat sleutels die je via /connect invoert op in het bestand ~/.local/share/opencode/auth.json. Als je niet telkens een model wilt kiezen, stel je het standaardmodel in het configuratiebestand opencode.json in de projectroot in:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

Het formaat is provider/model; beide identificaties worden weergegeven bij de uitvoer van /models.

Je eigen AI agent maken met OpenCode en Ollama: lokaal instellen#

Deze optie betekent helemaal geen API-kosten: het model draait op je computer. Kies je in het algemeen uit gratis modellen, dan hebben we een apart overzicht van welke modellen redelijk goed als agents werken en welke dat alleen op papier doen. Installeer voor OpenCode Ollama vanaf de officiële website en download een model:

ollama pull qwen3-coder

Een nuttig detail uit de documentatie: Ollama kan zichzelf automatisch configureren voor OpenCode; er is een aparte integratiehandleiding. Wil je alles handmatig instellen, voeg dan aan opencode.json een provider toe met het adres van je lokale Ollama-server:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

Daarna staat het lokale model in de lijst die /models in de interface toont. Selecteer het en ga aan de slag. Een praktische kanttekening uit de documentatie: als de agent geen tools meer aanroept (bestanden bewerken of opdrachten uitvoeren), verhoog dan num_ctx in de instellingen van Ollama — begin met waarden van 16k–32k. Lokale modellen zijn specifiek voor agentwerk zwakker dan cloudmodellen, en een kleine context maakt dat nog erger. Is de lokale versie niet voldoende, dan kun je Qwen vanuit de cloud koppelen met een sleutel; waar je die krijgt, staat in de handleiding hoe je een API-sleutel voor Qwen Code krijgt.

Hoeveel kosten OpenCode en het gebruik ervan?#

Alle kosten hier zijn voor het model en er zijn vier scenario’s. Met een API-sleutel of Zen betaal je voor werkelijk gebruik; het bedrag hangt af van hoeveel de agent werkt. Go is een abonnement voor open modellen van het OpenCode-team: $10 per maand voor Go en $40 per maand voor Go Plus met hogere limieten (geverifieerd op de pagina opencode.ai/go op 4 oktober 2026). De limiet hangt af van het model: Go staat bijvoorbeeld ongeveer 110 verzoeken per 5 uur (440 per maand) toe voor Kimi K3 en ongeveer 26.000 verzoeken per 5 uur voor het lichtere DeepSeek V4.1 Flash. Voor toegang tot een specifiek model boven de limiet vermeldt de documentatie een aparte prijs ($15 per maand voor Kimi K3, $60 voor Go Plus). Bekijk de abonnementspagina bij het koppelen voor de volledige lijst met modellen en limieten. Met ChatGPT Plus of Copilot vallen verzoeken onder het abonnement waarvoor je al betaalt; houd er rekening mee dat abonnementen hun eigen gebruikslimieten hebben. Tot slot kosten verzoeken aan een lokaal model via Ollama niets — maar je hebt een computer nodig die krachtig genoeg is om het model snel te draaien.

Wat doe je bij de eerste keer opstarten?#

De eerste keer opstarten — in je projectmap:

cd path/to/project
opencode

De interface opent met een invoerveld. Gebruik eerst de opdracht /init: de agent scant belangrijke repositorybestanden, stelt zo nodig een paar vragen en schrijft een AGENTS.md-bestand — een handleiding met de projectstructuur, opdrachten voor builds en tests en de gebruikte conventies. De documentatie raadt aan dit bestand aan git toe te voegen; OpenCode gebruikt het dan als permanente projectinstructie. Qua functie is AGENTS.md een direct equivalent van CLAUDE.md in het OpenCode-ecosysteem.

Gebruik ten tweede de Plan-modus. Met de Tab-toets wissel je tussen de twee hoofdagents: Build werkt met volledige toegang tot bestanden en opdrachten, terwijl Plan bedoeld is voor analyse en planning — bestandswijzigingen en bash-opdrachten in Plan-modus vereisen standaard je goedkeuring. Voor nieuwe taken raadt de documentatie aan met een plan te beginnen: lees wat de agent van plan is, pas de formulering aan en schakel pas daarna met Tab terug naar Build.

De documentatie geeft dit advies:

Hoe specifieker de taak en hoe meer context je geeft, hoe minder herwerk nodig is. Voeg bestanden met @ toe aan een verzoek — begin een naam te typen en de interface vindt ze met fuzzy search. Je kunt afbeeldingen rechtstreeks naar de terminal slepen. Een bericht dat met ! begint, wordt als shellopdracht uitgevoerd en de uitvoer wordt aan de context van de agent toegevoegd. Als je een fout hebt gemaakt in de opdracht of de agent iets verkeerd heeft gedaan, maakt /undo de wijzigingen ongedaan; je kunt die opdracht meerdere keren achter elkaar uitvoeren. Van gedachten veranderd? /redo herstelt wat ongedaan is gemaakt. En /share maakt een link naar een gesprek voor je team; zonder deze opdracht wordt het gesprek nergens gepubliceerd.

Wat kan OpenCode nog meer?#

Aangepaste opdrachten. Van elke terugkerende vraag kun je een opdracht maken: plaats een markdownbestand in .opencode/commands/, stel description, agent en model in de frontmatter in en schrijf daaronder een promptsjabloon. Roep de opdracht vervolgens aan met /. Projectcontroles voor publicatie, recente fouten bekijken, een migratie genereren — alles wat je regelmatig vraagt.

Subagents. Naast Build en Plan zijn er nog drie: General voor taken met meerdere stappen (toegang tot alle tools behalve de takenlijst), Explore om snel code te lezen zonder toestemming om die te bewerken en Scout om externe bibliotheken te onderzoeken. Roep ze aan door ze in een bericht met @ te noemen.

MCP-servers. Verbind externe tools via het gedeelte mcp in het configuratiebestand opencode.json — zowel lokale als externe servers worden ondersteund. Elke MCP-server voegt zijn tools aan de context toe. Een gulzige server zoals GitHub kan de context erg snel vullen, dus verbind selectief en alleen wat je nodig hebt. We hebben een handleiding met kant-en-klare configuraties over het MCP-concept; die is geschreven voor Claude Code, maar het protocol is gedeeld.

Webversie en server. opencode web opent de interface in een browser. Gebruik voor toegang vanaf een andere machine opencode serve --hostname 0.0.0.0 --port 4096; stel bij netwerktoegang altijd een wachtwoord in via de variabele OPENCODE_SERVER_PASSWORD. Zonder wachtwoord is de server niet beveiligd.

Wat doe je als er iets misgaat bij de installatie?#

“opencode: command not found” na de installatie. De terminal kent het nieuwe pad nog niet. Sluit de terminal eerst gewoon af en open hem opnieuw. Helpt dat niet, zoek dan waar de installer het binaire bestand heeft geplaatst en voeg die map toe aan PATH van je terminal.

Het model reageert niet of meldt een autorisatiefout. Controleer of de provider is verbonden: voer /connect in en meld je opnieuw aan. Sleutels worden opgeslagen in ~/.local/share/opencode/auth.json — als je de installatie van een andere machine hebt overgezet of mappen hebt leeggemaakt, kan het bestand ontbreken. De documentatie behandelt de fouten ProviderInitError en AI_APICallError afzonderlijk: autoriseer bij de eerste de provider opnieuw; wis bij de tweede de map ~/.cache/opencode en start opnieuw op.

De interface is kapot: panelen staan verspreid of er verschijnen onleesbare tekens in plaats van symbolen. Controleer eerst je terminal. Installeer een van de aanbevolen opties — WezTerm werkt op alle drie de systemen — en start OpenCode vanuit die terminal.

Helpt niets, controleer dan de logs: op macOS en Linux staan ze in ~/.local/share/opencode/log/; druk op Windows op Win+R en voer %USERPROFILE%\.local\share\opencode\log in. De tien meest recente bestanden worden bewaard; schakel gedetailleerde logging in met de vlag opencode --log-level DEBUG. Met die logs kun je een bugrapport indienen in de GitHub-repository van het project.

Wat vragen mensen nog meer over OpenCode?#

Ailoot openen.