OpenCode-installasjon og OmniProxy-konfigurasjon

OpenCode er en åpen kildekode-kodeassistent som lar deg skrive kode fra en terminal, IDE eller skrivebord. Den lagrer ikke koden eller konteksten din, noe som gjør den egnet for personvernsensitive prosjekter. build brukes til å endre et prosjekt, mens plan er skrivebeskyttet som standard og er nyttig for å forstå ukjent kode og planlegge endringer før du utfører dem. Du kan velge en modelltjeneste basert på dine behov.

Før du starter

Installasjonsskriptet er det enkleste alternativet. Du trenger en moderne terminal—et terminalprogram som kan kjøre kommandoer og jobbe med prosjektfiler—som WezTerm, Alacritty, Ghostty eller Kitty. På Windows foretrekkes WSL. Det gir et Linux-miljø i Windows med mer fullstendig ytelse og funksjonalitet.

Enklest

Installasjonsskript

• curl opencode.ai/install
• Bruk direkte på macOS Linux
• WSL anbefales på Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Oppdateres oftere enn formelen
• En pakke er også tilgjengelig for Arch

Native Windows

Pakkebehandler

• choco eller scoop
• Eller installer globalt med npm
• Du kan også laste den ned fra Releases

Klargjør også modell-ID-en fra gjeldende modelliste. En modell-ID er navnet tjenesten bruker for å identifisere en spesifikk modell nøyaktig.

Installer og start for første gang

Den enkleste installasjonskommandoen er:

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

Du kan også bruke en av disse installasjonsmetodene:

• Node.js: npm install -g opencode-ai. Bun, pnpm og Yarn har også tilsvarende globale installasjonskommandoer; se introduksjonssiden på slutten av denne guiden.
• Homebrew på macOS og Linux: brew install anomalyco/tap/opencode. Bruk denne tap-en fordi den oppdateres oftere enn brew install opencode, som vedlikeholdes av Homebrew-teamet.
• Arch Linux: bruk sudo pacman -S opencode for den stabile utgivelsen, eller AUR-pakken opencode-bin for en nyere versjon.
• Windows: bruk choco install opencode eller scoop install opencode. Du kan også bruke npm install -g opencode-ai. Binærfiler kan også lastes ned fra Releases. Støtte for installasjon med Bun på Windows er fortsatt under arbeid.

Gå inn i prosjektkatalogen din, og start deretter OpenCode:

cd /path/to/project
opencode

Når du bruker den for første gang, kan du kjøre /init. Den analyserer prosjektet og oppretter AGENTS.md i prosjektroten. Denne filen kan legges til i Git slik at prosjektet beholder disse instruksjonene.

Hent tilkoblingsverdier fra OmniProxy

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

baseURL er tjenesteadressen, API Key er tilgangslegitimasjonen, og Model ID er modellens fulle navn.

Når du bruker /v1/chat/completions, sett npm-pakken til @ai-sdk/openai-compatible. Chat Completions er en type chat-forespørselsgrensesnitt. Bytt til @ai-sdk/openai kun når modellen bruker /v1/responses. Når OmniProxy brukes gjennom chat completions-endepunktet, behold kompatibilitetspakken.

Kopier hele modell-ID-en fra OmniProxys gjeldende liste, inkludert eventuelle skråstreker. Per 2026-10-09 var to referanse-ID-er claude-sonnet-5-5 og gpt-6-luna. gpt-6-luna støtter Chat Completions; funksjonskall gjennom Chat Completions støttes kun når reasoning_effort er none. Ikke kopier en ID som ikke er i listen.

Angi verktøykonfigurasjonen

En leverandør (Provider) kan forstås som et sett med konfigurasjonsverdier OpenCode bruker for å koble til en modelltjeneste. Leverandørdokumentasjonen behandler en OpenAI-kompatibel tjeneste som ikke er oppført under /connect som en tilpasset leverandør. En OpenAI-kompatibel tjeneste bruker samme forespørselsformat og kan kalles opp av samme type klient.

1. Kjør /connect i OpenCode og bla til Other.
2. Skriv inn en leverandør-ID. Eksemplet nedenfor bruker omniproxy. Velg en ID som er lett å huske fordi du må bruke den samme i konfigurasjonsfilen.
3. Skriv inn OmniProxy API-nøkkelen. Dette trinnet lagrer kun legitimasjonen; adressen og modellene må fortsatt legges til i opencode.json. Legitimasjonen lagres i ~/.local/share/opencode/auth.json.
4. Opprett eller endre opencode.json i prosjektkatalogen:

{
  "$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. Kjør /models. Den tilpassede leverandøren og modellene dens vil vises i listen.

ID-en som skrives inn under /connect må samsvare med nøkkelen i opencode.json. Ikke legg en ekte hemmelig nøkkel i denne filen. Hvis du ikke bruker /connect, kan du bruke miljøvariabel-syntaks i options.apiKey, slik som {env:VARIABLE_NAME}. Under testing 2026-10-09 med OpenCode 1.18.34, fungerte det også å legge nøkkelen direkte i prosjektets options.apiKey uten å bruke /connect . Hvis gatewayen ikke validerer nøkkelen, kan denne verdien være en plassholderstreng som kun brukes på den lokale maskinen. Nøklene under models må bruke de fullstendige ID-ene fra listen.

Nøkkel

/connect

• Velg Other nederst
• Velg din egen leverandør-ID
• Lagret i auth.json

Prosjekt

opencode.json

• Leverandørnøkkelen må bruke samme navn
• Bruk en kompatibel npm-pakke
• baseURL slutter med /v1

Velg

/models

• Modellen vises i listen
• Velg én før du stiller et spørsmål
• Bruk ID-en fra gateway-listen

Bekreft med en ekte oppgave

Kjør én ekte oppgave fra prosjektkatalogen først. Modellreferanseformatet er Provider ID/model ID; behold eventuelle skråstreker i modell-ID-en:

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

--auto tillater denne kjøringen å bruke verktøy som fil-leseverktøy. Under testing 2026-10-09 med OpenCode 1.18.34, leste den innholdet i den spesifiserte filen. Den første kjøringen tok omtrent to minutter.

For interaktiv bruk, kjør opencode, velg deretter en modell med /models. Du kan bruke @ for å søke etter filer. Bruk opencode auth list for å bekrefte legitimasjonen som er lagret gjennom /connect, sjekk deretter OmniProxys forespørselslogger for å verifisere kilden og modell-ID-en.

Start

opencode starter

• Først cd til prosjektet
• auth list viser ID-en
• Konfigurasjonsfilen er i prosjektet

Oppgave

Den leste koden

• Spør om en spesifikk fil
• Gjennomgå forklaringen dens
• Bruk /undo hvis den er feil

Logger

Synlig i gatewayen

• Kilden er OpenCode
• Modell-ID samsvarer
• Ikke legg til nøkkelen i depotet

Vanlige feil

• OmniProxy vises ikke under /models: Sjekk at ID-en som er skrevet inn under /connect samsvarer med nøkkelen i opencode.json, at npm er satt til @ai-sdk/openai-compatible, og at baseURL slutter med /v1.
• Legitimasjonen mangler: Kjør opencode auth list. Leverandører som Bedrock som er avhengige av miljøvariabler vises ikke her; en tilpasset leverandør konfigurert gjennom /connect bør være synlig.
• Windows-funksjonalitet er ufullstendig: Bruk installasjonsskriptet inne i WSL i stedet.
• Modell-ID-en er ugyldig: Kopier den på nytt fra OmniProxys gjeldende liste og oppdater den tilsvarende nøkkelen under models.
• Forespørsler går til feil endepunkt: Behold @ai-sdk/openai-compatible for chat completions. Ikke endre pakken for Responses-grensesnittet med mindre den modellen på OmniProxy faktisk bruker /v1/responses.

Offisielle referanser

For installasjon, se OpenCode introduction. For tilpassede leverandører, se Providers. For modell-ID-ene som brukes i eksemplene, se Claude model overview og GPT-6 Luna.

Erstatt alle plassholdere med verdier fra din egen OmniProxy-konfigurasjon. Publisér aldri en ekte nøkkel.

Et lagret resultat eller HTTP 200 alene beviser ikke full kompatibilitet med en agent. Sjekk kilde og modell i OmniProxy sin kalllogg.

Offisielle kilder · OpenCode ↗