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 opdrachten 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
• Gebruik direct 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 globaal 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

De makkelijkste installatieopdracht 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 installatieopdrachten; zie de inleidingspagina 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 projectmap 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 projectroot. 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 toegangsgegeven 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 chatverzoek-interface. 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 9 oktober 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

Een 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 gegeven op; het adres en de modellen moeten nog steeds worden toegevoegd aan opencode.json. Het gegeven wordt opgeslagen in ~/.local/share/opencode/auth.json.
4. Maak of wijzig opencode.json in de projectmap:

{
  "$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 het testen op 9 oktober 2026 met OpenCode 1.18.34, maakte het direct plaatsen van de sleutel in de options.apiKey van het project zonder /connect te gebruiken ook succesvol verbinding. Als de gateway de sleutel niet valideert, kan deze waarde een placeholder-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 projectmap. 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 het testen op 9 oktober 2026 met OpenCode 1.18.34 las het succesvol 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 naar bestanden te zoeken. Gebruik opencode auth list om het gegeven te bevestigen dat is opgeslagen via /connect, en controleer vervolgens de verzoekrecords van OmniProxy om de bron en model-ID te verifiëren.

Starten

opencode start

• cd eerst 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-compatibleen dat baseURL eindigt op /v1.
• Het gegeven 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 in 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 OpenCode introduction voor installatie. Zie Providers voor aangepaste Providers. Zie 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 niet volledige agentcompatibiliteit. Controleer de bron en het model in de verzoeklog van OmniProxy.

Officiële bronnen · OpenCode ↗