OpenCode: installeren en instellen

OpenCode: ReviewInstalleren & instellenNieuwsTechnische tutorial

Stand september 2026, samengesteld uit onze eigen notities en nieuwsarchief; tekst machinaal opgesteld en redactioneel gecontroleerd. Controleer versies en commando's in de officiële documentatie.

In deze handleiding installeer je OpenCode, een open-source coding-agent voor de terminal, op macOS, Linux of Windows. Je koppelt een modelprovider, laat OpenCode je project leren kennen en zet de eerste veiligheidsinstellingen. Alles komt uit de officiële documentatie (stand september 2026).

Wat je nodig hebt

• Een terminal op macOS, Linux of Windows.
• Toegang tot minstens één taalmodel: een API-sleutel van een provider (bijvoorbeeld Anthropic, OpenAI of Google), OpenCodes eigen dienst Zen, of een lokaal model via Ollama of LM Studio.

OpenCode is er ook als desktop-app en als extensie voor je editor; deze handleiding gaat over de terminalversie.

Installeren

De snelste manier, op macOS en Linux:

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

Of kies wat bij je systeem past:

npm install -g opencode-ai                 # met Node.js
brew install anomalyco/tap/opencode        # Homebrew (macOS/Linux)

Op Windows:

choco install opencode     # Chocolatey
scoop install opencode     # Scoop

Of zonder iets te installeren, via Docker:

docker run -it --rm ghcr.io/anomalyco/opencode

Controleer daarna:

opencode --version

Een modelprovider koppelen

Start OpenCode en typ:

/connect

Kies je provider en plak je API-sleutel. OpenCode bewaart de sleutels in ~/.local/share/opencode/auth.json, buiten je projecten, dus ze komen niet in git terecht. Hetzelfde kan vanaf de commandoregel:

opencode auth login     # provider toevoegen
opencode auth list      # zien wat er gekoppeld is

Heb je nog geen sleutel, dan raadt OpenCode zijn eigen dienst Zen aan: inloggen op opencode.ai/auth, betaalgegevens invullen, sleutel kopiëren en die bij /connect plakken.

Wil je lokaal werken met Ollama, zie dan de tutorial: daar staat hoe je een eigen of lokale provider toevoegt.

Je project laten kennen

Ga naar je projectmap en start OpenCode:

cd ~/mijn-project
opencode

Typ dan:

/init

OpenCode bekijkt je project en maakt een AGENTS.md met de opbouw, commando's en conventies. Commit dat bestand, zodat OpenCode (en andere coding agents) het bij elke sessie gebruiken.

Plan of Build

Met Tab wissel je tussen de twee hoofdagents:

• Plan: analyseert en stelt voor, maar wijzigt geen code. Begin hiermee als je een onbekende codebase leert kennen.
• Build: heeft alle tools en voert wijzigingen uit.

Met @ verwijs je in je opdracht naar een bestand, bijvoorbeeld @src/auth.ts.

Eerste veiligheidsinstellingen

Standaard mag OpenCode de meeste acties zonder te vragen uitvoeren; .env-bestanden leest het standaard niet. Voor een voorzichtige start zet je in de root van je project een opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "ask",
    "bash": {
      "*": "ask",
      "git status": "allow",
      "npm test": "allow"
    }
  }
}

OpenCode vraagt dan eerst toestemming voor elke bewerking en elk shellcommando, behalve de twee die je vrijgeeft. Soepeler zetten kan altijd nog.

Controleren of het werkt

Een eenmalige opdracht zonder interactieve sessie:

opencode run "Leg in drie zinnen uit wat dit project doet."

Komt er een zinnig antwoord, dan werken installatie en provider.

Bijwerken

opencode upgrade

Een specifieke versie kan ook: opencode upgrade v1.2.3. Heb je via Homebrew, npm, Chocolatey of Scoop geïnstalleerd, dan kun je ook met dat programma bijwerken. Met de sleutel autoupdate in je configuratie bepaal je of OpenCode zichzelf bijwerkt (true), alleen meldt dat er een update is ("notify"), of niets doet (false).