OpenCode: installation, modeller och första starten

OpenCode är en AI-kodningsagent med öppen källkod för terminalen: själva verktyget är gratis (MIT-licens), och du kan ansluta vilken modell som helst – från Claude och GPT till en lokal modell via Ollama. Projektets repository har redan passerat tvåhundratusen stjärnor på GitHub. Formuleringen ”gratis Claude Code med valfri modell” låter lockande, men behöver förtydligas: verktyget är gratis; användningsvillkoren beror på vilken modell du väljer.

Här följer allt enligt den officiella dokumentationen: vad verktyget är, hur du installerar det på macOS, Linux eller Windows, hur du ansluter en modell och vad du gör vid den första starten. Det finns ett separat avsnitt om kostnader, eftersom ”gratis” här bara gäller verktyget: modeller kostar pengar, och det är oftast det som orsakar förvirring.

Praktisk information om att arbeta med Ailoot finns i dokumentationen.

Vad är OpenCode, enkelt förklarat?#

Kort sagt gör OpenCode samma sak som Claude Code: den tar emot en uppgift på vanligt språk och utför den i projektet. De skiljer sig åt på två sätt. Koden är helt öppen, så du kan läsa och granska den. Och verktyget är inte knutet till en enda modellleverantör: det fungerar med över 75 leverantörer, från Anthropic och OpenAI till en lokal modell som körs på din dator.

Projektet utvecklas av Anomaly-teamet. Repositoryt skapades den 30 april 2025 och hade den 4 oktober 2026 över 211 tusen stjärnor och 28 tusen forks (verifierat med en GitHub API-förfrågan). Språket är TypeScript. Dokumentationen uppdateras löpande, så instruktionerna nedan bygger på den aktuella versionen.

Blanda inte ihop namnen: npm-paketet för den aktuella serien heter opencode-ai, repositoryt är anomalyco/opencode, och terminalkommandot är helt enkelt opencode. Äldre artiklar kan använda adressen sst/opencode: organisationen bytte namn, och den gamla länken omdirigerar nu till den nya.

Uppdaterad 4 oktober 2026: teamet släppte OpenCode 2.0, nästa stora generation av verktyget. Installations- och modellanslutningsinstruktionerna nedan gäller fortfarande den aktuella 1.x-serien (installerad med kommandot curl -fsSL https://opencode.ai/install | bash; den aktuella versionen den 30 september 2026 är 1.18.34): den stöds aktivt och är den version som installeras enligt den officiella dokumentationen på opencode.ai/docs. Vad som exakt ändrades i den andra versionen och när det är dags att byta behandlas i ett separat avsnitt nedan.

Hur skiljer sig OpenCode från Claude Code och Codex?#

Om du redan har ett Claude-abonnemang är det rimligt att behålla Claude Code som ditt huvudsakliga verktyg – vi har en detaljerad installationsguide om det. OpenCode passar i tre fall: du vill arbeta via ett ChatGPT Plus- eller GitHub Copilot-abonnemang, köra en lokal modell utan API-kostnader eller ha ett enda gränssnitt för flera modeller. Vi har också en recension och installationsguide för Codex.

Om du fortfarande väljer verktyg kan du börja med den här översikten: vad folk kodar med 2026. Och om du redan har installerat OpenCode och behöver ansluta det till andra agenter i Devin Desktop via ACP kan du läsa vår guide till den konfigurationen.

Vad har ändrats i OpenCode 2.0?#

Den andra versionen installeras med kommandot curl -fsSL https://opencode.ai/v2/install | bash. Enligt den officiella migreringsguiden (opencode.ai/v2/docs/migrate-v1) använder båda versionerna samma opencode-kommando och installeras inte längre sida vid sida som standard: v2-installationsprogrammet ersätter v1-binären, och innan du installerar v2 via en pakethanterare ber dokumentationen uttryckligen att du först tar bort version v1. Konfigurationen läses dock från samma filer – ~/.config/opencode/ och <project>/.opencode/ – så inställningar, agenter och MCP-servrar följer med utan omskrivning. Tre saker behöver skrivas om: pluginer (de har ett nytt API), integrationer med server-API:t (protokollet har ändrats) och terminalinställningar (nu en gemensam cli.json-fil i stället för flera tui.json-filer).

De två mest anmärkningsvärda nyheterna i v2 är följande. För det första introducerades Console – en betaltjänst för team med användningsspårning, budgetar och gemensamma policyer för alla medlemmar. För det andra tillkännagav teamet äntligen priset på Go-abonnemanget: $10 per månad för Go och $40 per månad för Go Plus med högre gränser (sidan opencode.ai/go, verifierad den 4 oktober 2026). Tidigare sade dokumentationen bara ”billigt abonnemang”, utan någon siffra.

Om du är ny och bara vill installera agenten följer du instruktionerna nedan; de gäller den aktuella första versionen som själva dokumentationen rekommenderar. Överväg v2 om du behöver de nya pluginfunktionerna eller Console för team – men var beredd på att skriva om vissa äldre pluginer för det nya API:t. Om du hellre vill ha ett skrivbordsprogram med öppen källkod som inte kräver en terminal har vi en recension av ZCode, en annan liknande agent med eget gränssnitt.

Vad behöver du innan installationen?#

Lite mer om terminalen, eftersom det är den enda plats där installationen kanske inte går som planerat. OpenCode visar ett komplett gränssnitt med paneler och syntaxmarkering i terminalen, och därför ber dokumentationen dig använda en modern emulator. Om gränssnittet ser fel ut efter starten bör du först installera ett av de fyra namngivna alternativen: WezTerm (fungerar på alla system), Alacritty, Ghostty eller Kitty. På Windows är huvudalternativet WSL; det har ett eget avsnitt nedan.

Det andra du behöver är en modell. OpenCode fungerar via modellen du ansluter: på egen hand bearbetar den inga förfrågningar. Det finns fyra alternativ: ett abonnemang (ChatGPT Plus, GitHub Copilot, GitLab Duo), en API-nyckel från valfri leverantör, OpenCode Zen – teamets egen aggregator – eller en lokal modell via Ollama. Alla fyra alternativen tas upp i avsnittet om att ansluta en modell.

Utan en projektbeskrivning måste agenten gissa byggkommandon, filstruktur och de konventioner som används – därav ”hallucinationerna”. OpenCode använder en AGENTS.md-fil för detta. Samma tillvägagångssätt fungerar med Claude Code och alla andra agenter; det är bara namnet på instruktionsfilen som skiljer sig.

Hur installerar du OpenCode på macOS och Linux?#

Den rekommenderade vägen är det officiella installationsprogrammet:

1. Kör installationsprogrammet

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

   Skriptet identifierar ditt system och laddar ned OpenCode. Om kommandot inte hittas efter installationen stänger du terminalen och öppnar den igen; sökvägen hittas i den nya sessionen.

2. Kontrollera att installationen lyckades

   opencode --version
   

   Kommandot returnerar ett versionsnummer, vilket betyder att installationen lyckades. Svaret ”command not found” tar dig tillbaka till första steget: starta en ny terminalsession eller redigera PATH manuellt.

Om du föredrar att hantera paket själv finns här alternativen:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Homebrew-kommandot börjar avsiktligt med anomalyco/tap/: dokumentationen rekommenderar deras egen tap eftersom Homebrew-teamet uppdaterar formeln för brew install opencode mer sällan. Samma paketnamn, opencode-ai, fungerar också med bun, pnpm och yarn (bun install -g opencode-ai, yarn global add opencode-ai). På Arch Linux använder du sudo pacman -S opencode från den stabila programvarukällan eller paru -S opencode-bin för den senaste versionen från AUR.

Uppdatera OpenCode med opencode upgrade; när programmet startas hämtar det också uppdateringar på egen hand om automatisk uppdatering är aktiverad. Kontrollera versionen efter uppdateringen med det välbekanta opencode --version. Det finns också inbyggd avinstallation:

opencode uninstall

Kommandot visar exakt vad som kommer att tas bort och ber om bekräftelse. Du kan behålla konfiguration och sessionsdata om du vill: använd flaggorna --keep-config och --keep-data.

Hur installerar du OpenCode på Windows?#

Utvecklarna själva rekommenderar WSL som första alternativ. Installera det med ett kommando i PowerShell som körs som administratör:

wsl --install

Efter omstarten öppnar du Ubuntu från Start-menyn och kör det välbekanta kommandot där:

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

Dina filer på Windows-enheter är tillgängliga i WSL via /mnt/ – enhet C: finns på /mnt/c/ och enhet D: på /mnt/d/. Ett projekt på C:\Users\Name\project kan alltså öppnas så här:

cd /mnt/c/Users/Name/project
opencode

Det andra alternativet är att hoppa över WSL och använda pakethanterare för Windows. I PowerShell:

choco install opencode

scoop install opencode

Det tredje alternativet är datorprogrammet och webbversionen. Programmet installeras som ett vanligt program och visar gränssnittet i ett fönster, utan terminal. Webbversionen startas med kommandot opencode web: det öppnar OpenCode i en webbläsare, och dokumentationen rekommenderar även här att starta det från WSL för att undvika problem med filåtkomst. Dokumentationen listar också mindre vanliga alternativ – mise, Docker och en färdig binär från GitHub-sidan med utgåvor. Installation via bun på Windows är fortfarande under utveckling; använd npm-alternativet om bun är din huvudsakliga pakethanterare.

Hur ansluter du en modell till OpenCode?#

OpenCode stöder över 75 leverantörer via AI SDK och Models.dev, plus lokala modeller. De flesta ansluts med kommandot /connect i gränssnittet; för lokala modeller anger du också serveradressen i konfigurationen. Alternativen skiljer sig åt vad gäller betalningssätt och datorns krav:

Dokumentationen rekommenderar nybörjare att börja med OpenCode Zen. Teamet valde ut modeller som fungerar bra specifikt som agenter och testade kombinationerna med leverantörerna i sina egna uppgifter.

Så här ansluter du: skriv /connect, välj OpenCode Zen, logga in och lägg till betalning på opencode.ai/auth, hämta en nyckel och klistra in den. Därefter visar /models listan över rekommenderade modeller. Den 4 oktober 2026 innehåller listan till exempel GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 och Kimi K2.5. Dokumentationen påpekar ärligt att listan inte är fullständig och snabbt blir inaktuell eftersom nya modeller släpps varje vecka.

Abonnemang ansluts med samma kommando /connect: välj ChatGPT Plus eller GitHub Copilot i listan och logga in på ditt konto – ingen ytterligare konfiguration behövs.

Om du väljer Anthropic erbjuder /connect två alternativ: ange en API-nyckel manuellt eller välja Claude Pro/Max och autentisera via en webbläsare. Anthropic förbjuder dock tredjepartspluginer för användning av Claude Pro/Max-abonnemang, och inbyggda pluginer av det här slaget togs bort från OpenCode från och med version 1.3.0. Om du stöter på en äldre artikel om ”OpenCode via ett Claude-abonnemang” handlar den om borttagna pluginer, inte officiell auktorisering. Abonnemangen ChatGPT Plus, GitHub Copilot, GitLab Duo (markerat som experimentellt) och Atomic Chat fungerar utan ytterligare konfiguration.

OpenCode sparar nycklarna du anger via /connect i filen ~/.local/share/opencode/auth.json. Om du inte vill välja modell varje gång anger du standardmodellen i konfigurationsfilen opencode.json i projektets rot:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

Formatet är provider/model; båda identifierarna visas i resultatet från /models.

Hur ansluter du en lokal modell via Ollama?#

Det här alternativet innebär inga API-kostnader alls: modellen körs på din dator. Om du väljer mellan gratis modeller i allmänhet har vi en separat recension av vilka som fungerar någorlunda bra som agenter och vilka som bara gör det på papperet. För OpenCode installerar du Ollama från den officiella webbplatsen och hämtar en modell:

ollama pull qwen3-coder

En användbar detalj från dokumentationen: Ollama kan konfigurera sig automatiskt för OpenCode; det finns en separat integrationsguide. Om du vill konfigurera allt manuellt lägger du till en leverantör med adressen till din lokala Ollama-server i opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

Sedan visas den lokala modellen i listan i gränssnittet under /models. Välj den och börja arbeta. En praktisk reservation i dokumentationen: om agenten slutar anropa verktyg (redigera filer eller köra kommandon) ökar du num_ctx i Ollama-inställningarna – börja med värden på 16k–32k. Lokala modeller är svagare än molnmodeller just när det gäller agentarbete, och ett litet kontextfönster gör det värre. Om den lokala versionen inte räcker kan du ansluta Qwen från molnet med en nyckel; hur du skaffar en beskrivs i guiden så skaffar du en API-nyckel för Qwen Code.

Vad kostar OpenCode och användningen?#

Alla kostnader här gäller modellen, och det finns fyra scenarier. Med en API-nyckel eller Zen betalar du för faktisk användning, och beloppet beror på hur mycket agenten arbetar. Go är ett abonnemang för öppna modeller från OpenCode-teamet: $10 per månad för Go och $40 per månad för Go Plus med högre gränser (verifierat på sidan opencode.ai/go den 4 oktober 2026). Gränsen beror på modellen: Go tillåter till exempel omkring 110 förfrågningar per 5 timmar (440 per månad) för Kimi K3 och omkring 26 000 förfrågningar per 5 timmar för den lättare DeepSeek V4.1 Flash. För åtkomst till en viss modell utöver gränsen listar dokumentationen ett separat pris ($15 per månad för Kimi K3, $60 för Go Plus). Se abonnemangssidan när du ansluter för en fullständig lista över modeller och gränser. Med ChatGPT Plus eller Copilot täcks förfrågningarna av abonnemanget du redan betalar för; tänk bara på att abonnemang har egna användningsgränser. Slutligen kostar förfrågningar till en lokal modell via Ollama ingenting – men du behöver en tillräckligt kraftfull dator för att köra den snabbt.

Vad ska du göra vid den första starten?#

Första starten – i projektmappen:

cd path/to/project
opencode

Gränssnittet öppnas med ett inmatningsfält. Börja med kommandot /init: agenten skannar viktiga repositoryfiler, ställer ett par frågor vid behov och skriver en AGENTS.md-fil – en vägledning om projektets struktur, vilka kommandon som ska köras för byggen och tester samt vilka konventioner som används. Dokumentationen rekommenderar att du checkar in filen i git; OpenCode använder den sedan som en permanent projektinstruktion. AGENTS.md motsvarar i funktion CLAUDE.md direkt i OpenCode-ekosystemet.

Använd sedan Plan-läget. Med Tab-tangenten växlar du mellan de två huvudagenterna: Build arbetar med full åtkomst till filer och kommandon, medan Plan används för analys och planering – filändringar och bash-kommandon i Plan-läget kräver som standard ditt godkännande. För nya uppgifter rekommenderar dokumentationen att börja med en plan: läs vad agenten tänker göra, justera formuleringen och växla först därefter tillbaka till Build med Tab.

Dokumentationen ger följande råd:

Ju mer specifik uppgiften är och ju mer sammanhang du ger, desto mindre omarbete behövs. Lägg till filer i en förfrågan med @ – börja skriva ett namn så hittar gränssnittet dem med suddig sökning. Du kan dra bilder direkt till terminalen, och ett meddelande som börjar med ! körs som ett skalkommando; resultatet läggs till i agentens sammanhang. Om du gjorde ett misstag i uppgiften eller agenten gjorde fel ångrar /undo ändringarna, och du kan köra kommandot flera gånger i rad. Har du ändrat dig igen? /redo återställer det som ångrades. Och /share skapar en länk till en konversation för teamet; utan det här kommandot publiceras konversationen inte någonstans.

Vad mer kan OpenCode göra?#

Egna kommandon. Alla återkommande förfrågningar kan bli ett kommando: lägg en Markdown-fil i .opencode/commands/, ange description, agent och model i dess frontmatter och skriv en promptmall nedanför. Anropa sedan kommandot med /. Projektkontroller före publicering, granskning av senaste fel, generering av en migrering – vad du än ber om regelbundet.

Underagenter. Förutom Build och Plan finns det tre till: General för uppgifter i flera steg (åtkomst till alla verktyg utom uppgiftslistan), Explore för att snabbt läsa kod utan tillstånd att redigera och Scout för att undersöka externa bibliotek. Anropa dem genom att nämna dem med @ i ett meddelande.

MCP-servrar. Anslut externa verktyg via avsnittet mcp i konfigurationsfilen opencode.json – både lokala och fjärrservrar stöds. Varje MCP-server lägger till sina verktyg i sammanhanget, och en resurskrävande server som GitHub kan snabbt använda upp sammanhangsfönstret – anslut selektivt och bara det du behöver. Vi har en guide med färdiga konfigurationer om MCP-konceptet; den handlar om Claude Code, men protokollet är gemensamt.

Webbversion och server. opencode web öppnar gränssnittet i en webbläsare. För åtkomst från en annan dator använder du opencode serve --hostname 0.0.0.0 --port 4096; när nätverksåtkomst är möjlig måste du ange ett lösenord med variabeln OPENCODE_SERVER_PASSWORD. Utan lösenord är servern oskyddad.

Vad gör du om installationen går fel?#

”opencode: command not found” efter installationen. Terminalen känner ännu inte till den nya sökvägen. Börja med att stänga och öppna terminalen igen. Om det inte hjälper tar du reda på var installationsprogrammet lade binären och lägger till den mappen i terminalens PATH.

Modellen är tyst eller rapporterar ett auktoriseringsfel. Kontrollera att leverantören är ansluten: skriv /connect och autentisera igen. Nycklar sparas i ~/.local/share/opencode/auth.json – om du flyttade installationen från en annan dator eller rensade mappar kan filen saknas. Dokumentationen behandlar felen ProviderInitError och AI_APICallError separat: för det första ska du auktorisera leverantören igen; för det andra rensar du mappen ~/.cache/opencode och startar om.

Gränssnittet är trasigt: panelerna ligger huller om buller eller oläsliga tecken visas i stället för symboler. Börja med att kontrollera terminalen. Installera ett av de rekommenderade alternativen – WezTerm fungerar på alla tre systemen – och starta OpenCode därifrån.

Om inget hjälper kontrollerar du loggarna: på macOS och Linux finns de i ~/.local/share/opencode/log/; på Windows trycker du på Win+R och anger %USERPROFILE%\.local\share\opencode\log. De tio senaste filerna sparas; aktivera detaljerad loggning med flaggan opencode --log-level DEBUG. Med loggarna kan du skicka in en felrapport i projektets GitHub-repo.

Vad mer frågar folk om OpenCode?#

Öppna Ailoot.