Installation af OpenCode og konfiguration af OmniProxy

OpenCode er en open-source kodningsassistent, der lader dig skrive kode fra en terminal, IDE eller desktop. Den gemmer ikke din kode eller kontekst, hvilket gør den velegnet til privatlivsfølsomme projekter. build bruges til at ændre et projekt, mens plan er skrivebeskyttet som standard og er nyttig til at forstå ukendt kode og planlægge ændringer, før du foretager dem. Du kan vælge en modeltjeneste baseret på dine behov.

Før du starter

Installationsscriptet er den nemmeste mulighed. Du har brug for en moderne terminal—et terminalprogram, der kan køre kommandoer og arbejde med projektfiler—såsom WezTerm, Alacritty, Ghostty eller Kitty. På Windows foretrækkes WSL. Det giver et Linux-miljø i Windows med mere komplet ydeevne og funktionalitet.

Nemmeste

Installationsscript

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

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Opdateres oftere end formlen
• En pakke er også tilgængelig til Arch

Native Windows

Pakkehåndtering

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

Forbered også model-ID’et fra den aktuelle modelliste. Et model-ID er det navn, tjenesten bruger til at identificere en specifik model nøjagtigt.

Installation og første opstart

Den nemmeste installationskommando er:

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

Du kan også bruge en af disse installationsmetoder:

• Node.js: npm install -g opencode-ai. Bun, pnpm og Yarn har også tilsvarende globale installationskommandoer; se introduktionssiden i slutningen af denne guide.
• Homebrew på macOS og Linux: brew install anomalyco/tap/opencode. Brug dette tap, fordi det opdateres oftere end brew install opencode, som vedligeholdes af Homebrew-teamet.
• Arch Linux: brug sudo pacman -S opencode til den stabile udgivelse, eller AUR-pakken opencode-bin til en nyere version.
• Windows: brug choco install opencode eller scoop install opencode. Du kan også bruge npm install -g opencode-ai. Binære filer kan også downloades fra Releases. Understøttelse af installation med Bun på Windows er stadig undervejs.

Gå ind i din projektmappe, og start derefter OpenCode:

cd /path/to/project
opencode

Når du bruger den første gang, kan du køre /init. Den analyserer projektet og opretter AGENTS.md i projektets rodmappe. Denne fil kan committes til Git, så projektet bevarer disse instruktioner.

Hent forbindelsesværdier 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 adgangsoplysningerne, og Model ID er modellens fulde navn.

Når du bruger /v1/chat/completions, skal du indstille npm-pakken til @ai-sdk/openai-compatible. Chat Completions er en type chat-anmodningsgrænseflade. Skift til @ai-sdk/openai kun når modellen bruger /v1/responses. Når OmniProxy bruges gennem chat completions-slutpunktet, skal du beholde kompatibilitetspakken.

Kopier hele model-ID’et fra OmniProxy’s aktuelle liste, inklusive eventuelle skråstreger. Pr. 2026-10-09 var to reference-ID’er claude-sonnet-5-5 og gpt-6-luna. gpt-6-luna understøtter Chat Completions; funktionskald gennem Chat Completions understøttes kun, når reasoning_effort er none. Kopier ikke et ID, der ikke er på listen.

Indtast værktøjskonfigurationen

En udbyder kan forstås som et sæt konfigurationsværdier, OpenCode bruger til at oprette forbindelse til en modeltjeneste. Udbyderdokumentationen behandler en OpenAI-kompatibel tjeneste, der ikke er angivet under /connect som en brugerdefineret udbyder. En OpenAI-kompatibel tjeneste bruger det samme anmodningsformat og kan kaldes af den samme type klient.

1. Kør /connect i OpenCode og rul til Other.
2. Indtast et udbyder-ID. Eksemplet nedenfor bruger omniproxy. Vælg et ID, der er let at huske, fordi du skal bruge det samme i konfigurationsfilen.
3. Indtast OmniProxy API-nøglen. Dette trin gemmer kun legitimationsoplysningerne; adressen og modellerne skal stadig tilføjes til opencode.json. Legitimationsoplysningerne gemmes i ~/.local/share/opencode/auth.json.
4. Opret eller rediger opencode.json i projektmappen:

{
  "$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. Kør /models. Den brugerdefinerede udbyder og dens modeller vises på listen.

ID’et indtastet under /connect skal matche nøglen i opencode.json. Placer ikke en rigtig hemmelig nøgle i denne fil. Hvis du ikke bruger /connect, kan du bruge miljøvariabel-syntaks i options.apiKey, såsom {env:VARIABLE_NAME}. I test den 2026-10-09 med OpenCode 1.18.34, oprettede det også forbindelse, når nøglen blev placeret direkte i projektets options.apiKey uden at bruge /connect . Hvis gatewayen ikke validerer nøglen, kan denne værdi være en pladsholderstreng, der kun bruges på den lokale maskine. Nøglerne under models skal bruge de fuldstændige ID’er fra listen.

Nøgle

/connect

• Vælg Other nederst
• Vælg dit eget udbyder-ID
• Gemt i auth.json

Projekt

opencode.json

• Udbydernøglen skal bruge det samme navn
• Brug en kompatibel npm-pakke
• baseURL slutter med /v1

Vælg

/models

• Modellen vises på listen
• Vælg en, før du stiller et spørgsmål
• Brug ID'et fra gateway-listen

Bekræft med en rigtig opgave

Kør først én rigtig opgave fra projektmappen. Modelreferenceformatet er Provider ID/model ID; bevar eventuelle skråstreger i model-ID’et:

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

--auto tillader denne kørsel at bruge værktøjer såsom fil-læsningsværktøjer. I test den 2026-10-09 med OpenCode 1.18.34 læste den med succes den angivne fils indhold. Den første kørsel tog omkring to minutter.

Til interaktiv brug, kør opencode, og vælg derefter en model med /models. Du kan bruge @ til at søge efter filer. Brug opencode auth list til at bekræfte legitimationsoplysningerne gemt gennem /connect, og tjek derefter OmniProxy’s anmodningsoptegnelser for at bekræfte kilden og model-ID’et.

Start

opencode starter

• Først cd til projektet
• auth list viser ID'et
• Konfigurationsfilen er i projektet

Opgave

Den læste koden

• Spørg om en specifik fil
• Gennemgå dens forklaring
• Brug /undo hvis det er forkert

Logfiler

Synlig i gatewayen

• Kilden er OpenCode
• Model-ID matcher
• Commit ikke nøglen

Almindelige fejl

• OmniProxy vises ikke under /models: Tjek at ID’et indtastet under /connect matcher nøglen i opencode.json, at npm er indstillet til @ai-sdk/openai-compatible, og at baseURL slutter med /v1.
• Legitimationsoplysningerne mangler: Kør opencode auth list. Udbydere såsom Bedrock, der er afhængige af miljøvariabler, vises ikke her; en brugerdefineret udbyder konfigureret gennem /connect bør være synlig.
• Windows-funktionalitet er ufuldstændig: Brug installationsscriptet inde i WSL i stedet.
• Model-ID’et er ugyldigt: Kopier det igen fra OmniProxy’s aktuelle liste og opdater den tilsvarende nøgle under models.
• Anmodninger går til det forkerte slutpunkt: Behold @ai-sdk/openai-compatible til chat completions. Skift ikke pakken til Responses-grænsefladen, medmindre den model på OmniProxy faktisk bruger /v1/responses.

Officielle referencer

For installation, se OpenCode introduktion. For brugerdefinerede udbydere, se Udbydere. For model-ID’erne brugt i eksemplerne, se Claude modeloversigt og GPT-6 Luna.

Erstat alle pladsholdere med værdier fra din egen OmniProxy-konfiguration. Publicér aldrig en rigtig nøgle.

Et gemt resultat eller HTTP 200 alene beviser ikke fuld agentkompatibilitet. Tjek kilden og modellen i OmniProxys anmodningspost.

Officielle kilder · OpenCode ↗