OpenCode installatie en OmniProxy configuratie

OpenCode is een open-source codeerassistent waarmee je code kunt schrijven vanuit een terminal, IDE of desktop. Het slaat je code of context niet op, waardoor het geschikt is voor privacygevoelige projecten. build wordt gebruikt om een project te wijzigen, terwijl plan standaard alleen-lezen is en nuttig is voor het begrijpen van onbekende code en het plannen van wijzigingen voordat je ze doorvoert. Je kunt een modelservice kiezen op basis van je behoeften.

Voordat je begint

Het installatiescript is de makkelijkste optie. Je hebt een moderne terminal nodig—een terminalapplicatie die commando’s kan uitvoeren en met projectbestanden kan werken—zoals WezTerm, Alacritty, Ghostty of Kitty. Op Windows heeft WSL de voorkeur. Het biedt een Linux-omgeving binnen Windows met betere prestaties en functionaliteit.

Makkelijkste

Installatiescript

• curl opencode.ai/install
• Direct gebruiken op macOS Linux
• WSL wordt aanbevolen op Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Wordt vaker bijgewerkt dan de formule
• Er is ook een pakket beschikbaar voor Arch

Native Windows

Pakketbeheerder

• choco of scoop
• Of installeer wereldwijd met npm
• Je kunt het ook downloaden van Releases

Bereid ook de model-ID voor uit de huidige modellijst. Een model-ID is de naam die de service gebruikt om een specifiek model nauwkeurig te identificeren.

Installeren en voor de eerste keer opstarten

Het makkelijkste installatiecommando is:

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

Je kunt ook een van deze installatiemethoden gebruiken:

• Node.js: npm install -g opencode-ai. Bun, pnpm en Yarn hebben ook bijbehorende globale installatiecommando’s; zie de introductiepagina aan het einde van deze gids.
• Homebrew op macOS en Linux: brew install anomalyco/tap/opencode. Gebruik deze tap omdat deze vaker wordt bijgewerkt dan brew install opencode, die wordt onderhouden door het Homebrew-team.
• Arch Linux: gebruik sudo pacman -S opencode voor de stabiele release, of het AUR-pakket opencode-bin voor een nieuwere versie.
• Windows: gebruik choco install opencode of scoop install opencode. Je kunt ook npm install -g opencode-aigebruiken. Binaire bestanden kunnen ook worden gedownload van Releases. Ondersteuning voor installatie met Bun op Windows is nog in ontwikkeling.

Ga naar je projectdirectory en start OpenCode:

cd /path/to/project
opencode

Wanneer je het voor de eerste keer gebruikt, kun je /inituitvoeren. Het analyseert het project en maakt AGENTS.md aan in de project-root. Dit bestand kan worden gecommit naar Git, zodat het project deze instructies behoudt.

Verbindingswaarden ophalen uit OmniProxy

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

baseURL is het serviceadres, API Key is het toegangsbewijs en Model ID is de volledige naam van het model.

Stel bij gebruik van /v1/chat/completionshet npm-pakket in op @ai-sdk/openai-compatible. Chat Completions is een type interface voor chatverzoeken. Schakel alleen over naar @ai-sdk/openai wanneer het model /v1/responsesgebruikt. Wanneer OmniProxy wordt gebruikt via het chat completions-eindpunt, behoud dan het compatibiliteitspakket.

Kopieer de volledige model-ID uit de huidige lijst van OmniProxy, inclusief eventuele slashes. Op 09-10-2026 waren twee referentie-ID’s claude-sonnet-5-5 en gpt-6-luna. gpt-6-luna ondersteunt Chat Completions; functie-aanroepen via Chat Completions worden alleen ondersteund wanneer reasoning_effort is none. Kopieer geen ID die niet in de lijst staat.

De toolconfiguratie invoeren

A Provider kan worden begrepen als een set configuratiewaarden die OpenCode gebruikt om verbinding te maken met een modelservice. De Provider-documentatie behandelt een OpenAI-compatibele service die niet onder /connect staat als een aangepaste Provider. Een OpenAI-compatibele service gebruikt hetzelfde verzoekformaat en kan worden aangeroepen door hetzelfde type client.

1. Voer /connect uit in OpenCode en scrol naar Other.
2. Voer een Provider-ID in. Het onderstaande voorbeeld gebruikt omniproxy. Kies een ID die makkelijk te onthouden is, omdat je dezelfde moet gebruiken in het configuratiebestand.
3. Voer de OmniProxy API-sleutel in. Deze stap slaat alleen het bewijs op; het adres en de modellen moeten nog worden toegevoegd aan opencode.json. Het bewijs wordt opgeslagen in ~/.local/share/opencode/auth.json.
4. Maak of wijzig opencode.json in de projectdirectory:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. Voer /modelsuit. De aangepaste Provider en zijn modellen verschijnen in de lijst.

De ID die onder /connect is ingevoerd, moet overeenkomen met de sleutel in opencode.json. Zet geen echte geheime sleutel in dit bestand. Als je geen /connectgebruikt, kun je omgevingsvariabele-syntaxis gebruiken in options.apiKey, zoals {env:VARIABLE_NAME}. Tijdens tests op 09-10-2026 met OpenCode 1.18.34, werkte het ook door de sleutel rechtstreeks in de options.apiKey van het project te plaatsen zonder /connect te gebruiken. Als de gateway de sleutel niet valideert, kan deze waarde een tijdelijke tekenreeks zijn die alleen op de lokale machine wordt gebruikt. De sleutels onder models moeten de volledige ID’s uit de lijst gebruiken.

Sleutel

/connect

• Selecteer Other onderaan
• Kies je eigen Provider-ID
• Opgeslagen in auth.json

Project

opencode.json

• De provider-sleutel moet dezelfde naam gebruiken
• Gebruik een compatibel npm-pakket
• baseURL eindigt op /v1

Selecteer

/models

• Het model verschijnt in de lijst
• Selecteer er een voordat je een vraag stelt
• Gebruik de ID uit de gateway-lijst

Verifiëren met een echte taak

Voer eerst één echte taak uit vanuit de projectdirectory. Het formaat van de modelreferentie is Provider ID/model ID; behoud eventuele slashes binnen de model-ID:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Explain what a file you specify does. Do not modify the file."

--auto staat deze run toe om tools te gebruiken, zoals tools voor het lezen van bestanden. Tijdens tests op 09-10-2026 met OpenCode 1.18.34 las het met succes de inhoud van het opgegeven bestand. De eerste run duurde ongeveer twee minuten.

Voor interactief gebruik, voer opencodeuit en selecteer vervolgens een model met /models. Je kunt @ gebruiken om bestanden te zoeken. Gebruik opencode auth list om het bewijs te bevestigen dat is opgeslagen via /connect, en controleer vervolgens de verzoekrecords van OmniProxy om de bron en model-ID te verifiëren.

Opstarten

opencode start op

• Ga eerst met cd naar het project
• auth list toont de ID
• Het configuratiebestand staat in het project

Taak

Het las de code

• Vraag over een specifiek bestand
• Bekijk de uitleg
• Gebruik /undo als het fout is

Logboeken

Zichtbaar in de gateway

• Bron is OpenCode
• Model-ID komt overeen
• Commit de sleutel niet

Veelvoorkomende fouten

• OmniProxy verschijnt niet onder /models: Controleer of de ID die onder /connect is ingevoerd overeenkomt met de sleutel in opencode.json, dat npm is ingesteld op @ai-sdk/openai-compatible, en dat baseURL eindigt op /v1.
• Het bewijs ontbreekt: Voer opencode auth listuit. Providers zoals Bedrock die afhankelijk zijn van omgevingsvariabelen verschijnen hier niet; een aangepaste Provider die is geconfigureerd via /connect zou zichtbaar moeten zijn.
• Windows-functionaliteit is onvolledig: Gebruik het installatiescript binnen WSL.
• De model-ID is ongeldig: Kopieer deze opnieuw uit de huidige lijst van OmniProxy en werk de bijbehorende sleutel onder modelsbij.
• Verzoeken gaan naar het verkeerde eindpunt: Behoud @ai-sdk/openai-compatible voor chat completions. Wijzig het pakket voor de Responses-interface niet, tenzij dat model op OmniProxy daadwerkelijk /v1/responses.

gebruikt.

Officiële referenties

Zie voor installatie de OpenCode introduction. Zie voor aangepaste Providers Providers. Zie voor de model-ID’s die in de voorbeelden worden gebruikt de Claude model overview en GPT-6 Luna.

Vervang elke placeholder met waarden uit uw eigen OmniProxy-configuratie. Publiceer nooit een echte sleutel.

Een opgeslagen resultaat of HTTP 200 alleen bewijst geen volledige Agent-compatibiliteit. Controleer de bron en het model in het oproeprecord van OmniProxy.

Officiële bronnen · OpenCode ↗