Viktiga punkter

• Flera installationsvägar: npm, Homebrew, curl-skript, Go install, Docker och att bygga från källkod -- välj den som passar din verktygskedja.
• Fem minuter till första körning: Den snabbaste vägen (curl-installationsskriptet) får igång OpenCode på under fem minuter på vilket Unix-system som helst.
• Leverantörsoberoende: OpenCode fungerar med OpenAI, Google Gemini, Ollama lokala modeller och mer -- du är inte låst till en enda AI-leverantör.
• Minimal konfiguration: En enda config.toml-fil och en miljövariabel är allt du behöver för att börja koda med AI i din terminal.

Hur du installerar OpenCode: Steg-för-steg installationsguide (2026)

OpenCode är den öppna källkodens AI-kodningsagent byggd för terminalen. Den tar kraften hos stora språkmodeller direkt till din kommandorad, vilket låter dig skriva, refaktorera, felsöka och förstå kod utan att lämna din editor eller ditt terminal-arbetsflöde.

Oavsett om du sätter upp OpenCode för första gången eller migrerar från ett annat AI-kodningsverktyg, guidar denna guide dig genom varje installationsmetod, initial konfiguration, leverantörsuppsättning och felsökningssteg du kommer att behöva.

---

Förutsättningar

Innan du installerar OpenCode, bekräfta att ditt system uppfyller följande krav.

Operativsystem

OpenCode körs på macOS, Linux och Windows. För Windows-användare rekommenderas WSL (Windows Subsystem for Linux) starkt. Inbyggt stöd för Windows via Scoop finns också tillgängligt.

Systemkrav för körning (beror på installationsmetod)

Installationsmetod	Krav
npm	Node.js 18 eller högre
Homebrew	macOS eller Linux med Homebrew installerat
Curl-skript	bash, curl
Go install	Go 1.22 eller högre
Docker	Docker Engine 20+
Bygg från källkod	Go 1.22+, Git

Terminalkrav

OpenCode tillhandahåller ett TUI (Terminal User Interface), så din terminalemulator måste stödja true color och korrekt Unicode-rendering. De flesta moderna terminaler (iTerm2, Alacritty, WezTerm, Windows Terminal, Ghostty) fungerar direkt. Äldre terminaler som standard-macOS Terminal.app kan ha renderingsproblem.

Kontrollera din Node.js-version:

node --version

Kontrollera din Go-version (om du använder Go install-metoden):

go version

---

Metod 1: Installationsskript (Snabbast)

Det officiella installationsskriptet är det snabbaste sättet att få igång OpenCode. Det detekterar ditt OS och din arkitektur, laddar ner rätt binary och placerar den i din PATH.

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

Detta enda kommando hanterar allt. När det är klart, verifiera installationen:

opencode --version

Denna metod fungerar på macOS och Linux. Den kräver inte Node.js eller Go.

---

Metod 2: npm-installation

Om du redan har Node.js i ditt arbetsflöde är npm det mest bekanta alternativet.

npm install -g opencode-ai@latest

Paketnamnet på npm är opencode-ai, inte opencode. Detta är en vanlig källa till förvirring.

För att verifiera:

opencode --version

Om du stöter på behörighetsfel, fixa antingen dina behörigheter för npm:s globala katalog eller använd npx för att köra det utan en global installation:

npx opencode-ai@latest

---

Metod 3: Homebrew (macOS och Linux)

Homebrew-användare kan installera OpenCode från den officiella tap:en:

brew install anomalyco/tap/opencode

Detta installerar den senaste stabila versionen och hanterar uppdateringar via brew upgrade.

För att verifiera:

opencode --version

---

Metod 4: Go install

Om du har Go 1.22+ installerat kan du installera direkt från källkoden via go install:

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

Se till att $GOPATH/bin (eller $HOME/go/bin som standard) finns i din PATH. Lägg till det i din shell profile om det inte redan finns där:

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

Verifiera:

opencode --version

---

Metod 5: Docker

Att köra OpenCode i Docker är användbart för CI/CD-pipelines eller när du vill ha en isolerad miljö.

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

Kör det med din projektkatalog monterad:

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

-it-flaggorna är nödvändiga eftersom OpenCode använder ett interaktivt TUI. -v-flaggan monterar din nuvarande projektkatalog så att OpenCode kan läsa och ändra dina filer.

---

Metod 6: Bygg från källkod

För bidragsgivare eller för den som vill ha den allra senaste versionen:

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

Flytta binary-filen till en katalog i din PATH:

sudo mv opencode /usr/local/bin/

Att bygga från källkod kräver Go 1.22+ och Git. Detta ger dig tillgång till osläppta funktioner och låter dig modifiera verktyget för dina egna behov.

---

Metod 7: Scoop (Windows)

Windows-användare som föredrar en inbyggd upplevelse framför WSL kan använda Scoop:

scoop install opencode

Scoop hanterar PATH-konfigurationen automatiskt.

---

Första start och konfiguration

Med OpenCode installerat, navigera till valfri projektkatalog och starta det:

cd your-project
opencode

Vid första start öppnar OpenCode sitt TUI och ber dig ansluta en AI-leverantör. Du kan använda det interaktiva /connect-kommandot för att lägga till din API-nyckel:

/connect

Detta guidar dig genom att välja en leverantör (OpenAI, Google, Anthropic, etc.) och ange din API-nyckel. Inloggningsuppgifter lagras i ~/.local/share/opencode/auth.json.

För en snabbare start kan du också initiera ditt projekt med:

/init

Detta analyserar din lagringsplats struktur och skapar en agents.md-fil med kontext om din kodbas, vilket hjälper AI:n att ge mer exakta svar från början.

---

Konfigurera AI-leverantörer

OpenCode stöder flera AI-leverantörer. Här är hur du konfigurerar var och en.

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

Ställ in din API-nyckel som en miljövariabel:

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

Eller lägg till den i din shell profile (~/.zshrc, ~/.bashrc) för permanens.

Google Gemini (Gemini 2.5 Pro, Gemini 2.5 Flash)

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

Du kan skaffa en Google API-nyckel från Google AI Studio.

Ollama (Lokala modeller -- Gratis, Privat)

Ollama låter dig köra modeller lokalt utan någon API-nyckel. Installera Ollama först, hämta en modell, och konfigurera sedan OpenCode:

# Installera Ollama (om det inte redan är installerat)
curl -fsSL https://ollama.com/install.sh | sh

# Hämta en kodningsmodell
ollama pull qwen2.5-coder:32b

# OpenCode detekterar Ollama automatiskt när det körs på localhost:11434

Ingen API-nyckel behövs för Ollama. OpenCode detekterar det automatiskt när det körs lokalt.

Anthropic (Claude -- Begränsad åtkomst)

Anthropic har begränsat Claude-åtkomst i tredjepartsverktyg inklusive OpenCode. Om du har en API-nyckel som fortfarande fungerar:

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

De flesta användare under 2026 använder dock OpenAI eller Google Gemini som sin primära leverantör med OpenCode på grund av dessa restriktioner.

---

Viktig konfiguration: Genomgång av config.toml

OpenCode använder en TOML-konfigurationsfil för detaljerad kontroll. Konfigurationsfilen finns på ~/.config/opencode/config.toml (eller i din projektrot som opencode.json för projektspecifika inställningar).

Här är ett praktiskt exempel på en config.toml:

# Leverantörskonfiguration
[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"

# Inaktivera leverantörer du inte använder
disabled_providers = ["anthropic"]

Viktiga saker att notera:

• Variabelsubstitution: Använd {env:VARIABLE_NAME} för att referera till miljövariabler istället för att hårdkoda nycklar.
• Val av modell: Du kan specificera exakt vilken modell som ska användas under varje leverantör.
• Inaktiverade leverantörer: Förhindra att OpenCode laddar leverantörer vars uppgifter du inte har, för att undvika varningar vid uppstart.
• Override av bas-URL: Om du använder en proxy eller anpassad slutpunkt, lägg till baseURL = "https://your-proxy.com/v1" under leverantörssektionen.

För konfiguration på projektnivå, skapa en opencode.json i din projektrot:

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

Detta skriver över globala inställningar för det specifika projektet.

---

Verifiera din installation

Gå igenom denna checklista för att bekräfta att allt fungerar korrekt.

1. Kontrollera versionen

opencode --version

Du bör se versionsnumret skrivas ut. Från och med mars 2026 ligger den senaste stabila versionen i 0.x-intervallet.

2. Starta TUI

cd any-project-directory
opencode

Du bör se OpenCode-terminalgränssnittet med en prompt längst ner.

3. Testa en enkel prompt

I OpenCode TUI, skriv en enkel begäran:

Förklara vad detta projekt gör baserat på filstrukturen.

Om du får ett svar från AI:n fungerar din leverantörskonfiguration.

4. Testa filoperationer

Be OpenCode att skapa en liten testfil:

Skapa en fil som heter test-opencode.txt med texten "OpenCode fungerar"

Kontrollera att filen skapades i din projektkatalog och ta sedan bort den.

---

Felsökning av vanliga problem

"command not found: opencode"

Binary-filen finns inte i din PATH. Lösningar beror på din installationsmetod:

• npm: Kör npm list -g opencode-ai för att bekräfta installationen. Om installerad, kontrollera att npm:s globala bin-katalog finns i din PATH: npm config get prefix och lägg till /bin till den sökvägen.
• Go: Lägg till $(go env GOPATH)/bin i din PATH.
• Curl-skript: Kör om installationsskriptet eller flytta binary-filen manuellt till /usr/local/bin/.

Behörighetsfel under npm-installation

Använd inte sudo npm install -g. Fixa istället npm:s standardkatalog:

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"

OpenCode:s npm-paket kräver Node.js 18+. Kontrollera din version:

node --version

Om du har en äldre version, uppgradera med nvm:

nvm install 18
nvm use 18

Nätverksfel bakom en företagsbrandvägg

Om npm-installationen hänger sig eller misslyckas på grund av nätverksrestriktioner:

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

Eller ladda ner binary-filen direkt från GitHub releases page och placera den manuellt i din PATH.

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

Se till att miljövariabeln för din API-nyckel är exporterad i samma terminalsession:

echo $OPENAI_API_KEY

Om inget skrivs ut, ställ in den igen:

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

För permanens, lägg till export-raden i din ~/.zshrc eller ~/.bashrc och kör source ~/.zshrc.

Problem med TUI-rendering (konstig text, saknade ramar)

Byt till en modern terminalemulator som stöder true color. Rekommenderade alternativ: iTerm2 (macOS), Alacritty (plattformsoberoende), WezTerm (plattformsoberoende) eller Windows Terminal (Windows).

Go install: "go: command not found"

Go är inte installerat eller finns inte i din PATH. Installera Go från go.dev/dl och se till att det finns i din PATH:

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

---

Uppdatera OpenCode

Håll OpenCode uppdaterad för att få det senaste modellstödet och buggfixar.

npm:

npm update -g opencode-ai

Homebrew:

brew upgrade opencode

Curl-skript: Kör installationskommandot igen:

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

Go install: Kör igen med @latest:

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

---

Nästa steg

Nu när OpenCode är installerat och konfigurerat är du redo att börja använda det i ditt dagliga arbetsflöde.

• Lär dig kommandona: Kolla in vår OpenCode Tutorial 2026 för en fullständig genomgång av kommandon, arbetsflöden och avancerade funktioner.
• Ställ in GitHub-integration: Installera OpenCode GitHub App för att använda AI-driven kodgranskning och svar på issues direkt i dina lagringsplatser.
• Utforska /init-kommandot: Kör /init i ditt projekt för att generera en agents.md-fil som ger OpenCode djup kontext om din kodbas arkitektur.
• Prova flera leverantörer: Konfigurera två eller tre leverantörer och växla mellan dem för att hitta vilken modell som fungerar bäst för dina kodningsuppgifter.

OpenCode är ett av de snabbast växande AI-verktygen med öppen källkod under 2026 eftersom det möter utvecklare där de redan arbetar: i terminalen. Med en installation som tar under fem minuter och en konfiguration som bara kräver en API-nyckel, finns det ingen anledning att inte prova det idag.