Vigtigste pointer

• Flere installationsveje: npm, Homebrew, curl script, Go install, Docker og opbygning fra kildekode -- vælg den, der passer til din toolchain.
• Fem minutter til første kørsel: Den hurtigste vej (curl installationsscript) får OpenCode kørende på under fem minutter på ethvert Unix-system.
• Uafhængig af udbyder: OpenCode fungerer med OpenAI, Google Gemini, Ollama lokale modeller og mere -- du er ikke låst til en enkelt AI-udbyder.
• Konfigurationen er minimal: En enkelt config.toml fil og én miljøvariabel er alt, hvad du behøver for at begynde at kode med AI i din terminal.

Sådan installerer du OpenCode: Trin-for-trin opsætningsguide (2026)

OpenCode er den open-source AI-kodningsagent bygget til terminalen. Den bringer kraften fra store sprogmodeller direkte ind i din kommandolinje, så du kan skrive, refactor, debugge og forstå kode uden at forlade din editor eller terminal-workflow.

Uanset om du opsætter OpenCode for første gang eller migrerer fra et andet AI-kodningsværktøj, guider denne guide dig gennem hver installationsmetode, indledende konfiguration, udbyderopsætning og fejlfindingstrin, du får brug for.

---

Forudsætninger

Før du installerer OpenCode, skal du bekræfte, at dit system opfylder følgende krav.

Operativsystem

OpenCode kører på macOS, Linux og Windows. For Windows-brugere anbefales WSL (Windows Subsystem for Linux) kraftigt. Native Windows-understøttelse via Scoop er også tilgængelig.

Runtime-krav (afhænger af installationsmetode)

Installationsmetode	Krav
npm	Node.js 18 eller højere
Homebrew	macOS eller Linux med Homebrew installeret
Curl script	bash, curl
Go install	Go 1.22 eller højere
Docker	Docker Engine 20+
Build from source	Go 1.22+, Git

Terminal-krav

OpenCode leverer en TUI (Terminal User Interface), så din terminalemulator skal understøtte true color og korrekt Unicode-rendering. De fleste moderne terminaler (iTerm2, Alacritty, WezTerm, Windows Terminal, Ghostty) fungerer med det samme. Ældre terminaler som standard macOS Terminal.app kan have problemer med rendering.

Tjek din Node.js-version:

node --version

Tjek din Go-version (hvis du bruger Go install-metoden):

go version

---

Metode 1: Installationsscript (Hurtigst)

Det officielle installationsscript er den hurtigste måde at få OpenCode kørende på. Det registrerer dit OS og din arkitektur, downloader den korrekte binary og placerer den i din PATH.

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

Denne enkelte kommando håndterer alt. Når den er færdig, skal du bekræfte installationen:

opencode --version

Denne metode fungerer på macOS og Linux. Den kræver ikke Node.js eller Go.

---

Metode 2: npm-installation

Hvis du allerede har Node.js i dit workflow, er npm den mest velkendte mulighed.

npm install -g opencode-ai@latest

Pakkenavnet på npm er opencode-ai, ikke opencode. Dette er en almindelig kilde til forvirring.

For at bekræfte:

opencode --version

Hvis du støder på rettighedsfejl, skal du enten rette dine npm globale biblioteksrettigheder eller bruge npx for at køre det uden en global installation:

npx opencode-ai@latest

---

Metode 3: Homebrew (macOS og Linux)

Homebrew-brugere kan installere OpenCode fra det officielle tap:

brew install anomalyco/tap/opencode

Dette installerer den seneste stabile version og håndterer opdateringer via brew upgrade.

For at bekræfte:

opencode --version

---

Metode 4: Go install

Hvis du har Go 1.22+ installeret, kan du installere direkte fra kildekoden via go install:

go install github.com/opencode-ai/opencode@latest

Sørg for, at $GOPATH/bin (eller $HOME/go/bin som standard) er i din PATH. Tilføj det til din shell-profil, hvis det ikke allerede er der:

export PATH="$PATH:$(go env GOPATH)/bin"

Bekræft:

opencode --version

---

Metode 5: Docker

At køre OpenCode i Docker er nyttigt til CI/CD-pipelines, eller når du ønsker et isoleret miljø.

docker pull ghcr.io/opencode-ai/opencode:latest

Kør det med dit projektbibliotek monteret:

docker run -it --rm \
  -v "$(pwd)":/workspace \
  -w /workspace \
  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
  ghcr.io/opencode-ai/opencode:latest

-it flags er afgørende, fordi OpenCode bruger en interaktiv TUI. -v flaget monterer dit nuværende projektbibliotek, så OpenCode kan læse og ændre dine filer.

---

Metode 6: Byg fra kildekode

For bidragydere eller enhver, der ønsker den absolut nyeste version:

git clone https://github.com/opencode-ai/opencode.git
cd opencode
go build -o opencode .

Flyt binary-filen til et bibliotek i din PATH:

sudo mv opencode /usr/local/bin/

Opbygning fra kildekode kræver Go 1.22+ og Git. Dette giver dig adgang til ikke-udgivne funktioner og lader dig ændre værktøjet til dine egne behov.

---

Metode 7: Scoop (Windows)

Windows-brugere, der foretrækker en native oplevelse frem for WSL, kan bruge Scoop:

scoop install opencode

Scoop håndterer PATH-konfiguration automatisk.

---

Første start og konfiguration

Med OpenCode installeret, naviger til ethvert projektbibliotek og start det:

cd your-project
opencode

Ved første start åbner OpenCode sin TUI og beder dig om at forbinde en AI-udbyder. Du kan bruge den interaktive /connect kommando til at tilføje din API-nøgle:

/connect

Dette guider dig gennem valg af en udbyder (OpenAI, Google, Anthropic, etc.) og indtastning af din API-nøgle. Loginoplysninger gemmes i ~/.local/share/opencode/auth.json.

For en hurtigere start kan du også initialisere dit projekt med:

/init

Dette analyserer din repository-struktur og opretter en agents.md fil med kontekst om din kodebase, hvilket hjælper AI'en med at give mere nøjagtige svar fra starten.

---

Konfigurer AI-udbydere

OpenCode understøtter flere AI-udbydere. Her er, hvordan du konfigurerer hver enkelt.

OpenAI (GPT-5.4, GPT-4.1, o3)

Indstil API-nøglen som en miljøvariabel:

export OPENAI_API_KEY="sk-your-key-here"

Eller tilføj den til din shell-profil (~/.zshrc, ~/.bashrc) for at gøre den permanent.

Google Gemini (Gemini 2.5 Pro, Gemini 2.5 Flash)

export GOOGLE_API_KEY="your-google-api-key"

Du kan få en Google API-nøgle fra Google AI Studio.

Ollama (Lokale modeller -- Gratis, Privat)

Ollama lader dig køre modeller lokalt uden nogen API-nøgle. Installer Ollama først, hent en model, og konfigurer derefter OpenCode:

# Installer Ollama (hvis ikke allerede installeret)
curl -fsSL https://ollama.com/install.sh | sh

# Hent en kodningsmodel
ollama pull qwen2.5-coder:32b

# OpenCode registrerer automatisk Ollama, når det kører på localhost:11434

Der kræves ingen API-nøgle til Ollama. OpenCode finder det automatisk, når det kører lokalt.

Anthropic (Claude -- Begrænset adgang)

Anthropic har begrænset Claude-adgang i tredjepartsværktøjer, herunder OpenCode. Hvis du har en API-nøgle, der stadig virker:

export ANTHROPIC_API_KEY="sk-ant-your-key-here"

De fleste brugere i 2026 bruger dog OpenAI eller Gemini som deres primære udbyder med OpenCode på grund af disse restriktioner.

---

Vigtig konfiguration: Gennemgang af config.toml

OpenCode bruger en TOML-konfigurationsfil til finkornet kontrol. Konfigurationsfilen findes i ~/.config/opencode/config.toml (eller i din projektrod som opencode.json for projektspecifikke indstillinger).

Her er et praktisk eksempel på en config.toml:

# Provider configuration
[provider.openai]
apiKey = "{env:OPENAI_API_KEY}"

[provider.openai.models.gpt]
id = "gpt-5.4"

[provider.google]
apiKey = "{env:GOOGLE_API_KEY}"

[provider.google.models.gemini]
id = "gemini-2.5-pro"

# Disable providers you do not use
disabled_providers = ["anthropic"]

Vigtige ting at bemærke:

• Variabelerstatning: Brug {env:VARIABLE_NAME} til at referere til miljøvariabler i stedet for at hardcode nøgler.
• Modelvalg: Du kan angive præcis, hvilken model der skal bruges under hver udbyder.
• Deaktiverede udbydere: Undgå, at OpenCode indlæser udbydere, hvis loginoplysninger du ikke har, for at undgå opstartsadvarsler.
• Base URL override: Hvis du bruger en proxy eller et brugerdefineret endpoint, skal du tilføje baseURL = "https://your-proxy.com/v1" under udbydersektionen.

For konfiguration på projektniveau skal du oprette en opencode.json i din projektrod:

{
  "provider": "openai",
  "model": "gpt-5.4"
}

Dette tilsidesætter globale indstillinger for det specifikke projekt.

---

Bekræft din installation

Gennemgå denne tjekliste for at bekræfte, at alt fungerer korrekt.

1. Tjek versionen

opencode --version

Du bør se versionsnummeret blive udskrevet. Fra og med marts 2026 er den seneste stabile version i 0.x-området.

2. Start TUI

cd any-project-directory
opencode

Du bør se OpenCode-terminalinterfacet med en prompt i bunden.

3. Test en simpel prompt

I OpenCode TUI, skriv en simpel anmodning:

Explain what this project does based on the file structure.

Hvis du får et svar fra AI'en, fungerer din udbyderkonfiguration.

4. Test filoperationer

Bed OpenCode om at oprette en lille testfil:

Create a file called test-opencode.txt with the text "OpenCode is working"

Tjek, at filen blev oprettet i dit projektbibliotek, og slet den derefter.

---

Fejlfinding af almindelige problemer

"command not found: opencode"

Binary-filen er ikke i din PATH. Løsninger afhænger af din installationsmetode:

• npm: Kør npm list -g opencode-ai for at bekræfte installationen. Hvis den er installeret, skal du tjekke, at npm's globale bin-bibliotek er i din PATH: npm config get prefix og tilføj /bin til den sti.
• Go: Tilføj $(go env GOPATH)/bin til din PATH.
• Curl script: Kør installationsscriptet igen, eller flyt manuelt binary-filen til /usr/local/bin/.

Rettighedsfejl under npm-installation

Brug ikke sudo npm install -g. Ret i stedet npm's standardbibliotek:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
npm install -g opencode-ai@latest

"Error: Node.js version too old"

OpenCodes npm-pakke kræver Node.js 18+. Tjek din version:

node --version

Hvis du er på en ældre version, skal du opgradere ved hjælp af nvm:

nvm install 18
nvm use 18

Netværksfejl bag en virksomheds-firewall

Hvis npm-installationen går i stå eller fejler på grund af netværksrestriktioner:

npm install -g opencode-ai@latest --registry https://registry.npmmirror.com

Eller download binary-filen direkte fra GitHub releases page og placer den manuelt i din PATH.

"API key not found" eller "No provider configured"

Sørg for, at din API-nøgle-miljøvariabel er eksporteret i den samme shell-session:

echo $OPENAI_API_KEY

Hvis den ikke udskriver noget, skal du indstille den igen:

export OPENAI_API_KEY="sk-your-key-here"

For at gøre det permanent skal du tilføje eksportlinjen til din ~/.zshrc eller ~/.bashrc og køre source ~/.zshrc.

TUI-renderingsproblemer (forvansket tekst, manglende rammer)

Skift til en moderne terminalemulator, der understøtter true color. Anbefalede muligheder: iTerm2 (macOS), Alacritty (cross-platform), WezTerm (cross-platform) eller Windows Terminal (Windows).

Go install: "go: command not found"

Go er ikke installeret eller ikke i din PATH. Installer Go fra go.dev/dl og sørg for, at det er i din PATH:

export PATH="$PATH:/usr/local/go/bin"

---

Opdatering af OpenCode

Hold OpenCode opdateret for at få den nyeste modelunderstøttelse og fejlrettelser.

npm:

npm update -g opencode-ai

Homebrew:

brew upgrade opencode

Curl script: Kør installationskommandoen igen:

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

Go install: Kør igen med @latest:

go install github.com/opencode-ai/opencode@latest

---

Næste skridt

Nu hvor OpenCode er installeret og konfigureret, er du klar til at begynde at bruge det i dit daglige workflow.

• Lær kommandoerne: Tjek vores OpenCode Tutorial 2026 for en fuld gennemgang af kommandoer, workflows og avancerede funktioner.
• Opsæt GitHub-integration: Installer OpenCode GitHub App for at bruge AI-drevet kodereview og svar på issues direkte i dine repositories.
• Udforsk /init kommandoen: Kør /init i dit projekt for at generere en agents.md fil, der giver OpenCode dyb kontekst om din kodebasearkitektur.
• Prøv flere udbydere: Konfigurer to eller tre udbydere og skift mellem dem for at finde ud af, hvilken model der fungerer bedst til dine kodningsopgaver.

OpenCode er et af de hurtigst voksende open-source AI-værktøjer i 2026, fordi det møder udviklere der, hvor de allerede arbejder: i terminalen. Da installationen tager under fem minutter og konfigurationen kun kræver én API-nøgle, er der ingen grund til ikke at prøve det i dag.