OpenCode: asennus, mallit ja ensimmäinen käynnistys

OpenCode on avoimen lähdekoodin tekoälykoodausagentti päätelaitteelle: itse työkalu on ilmainen (MIT-lisenssi), ja siihen voi yhdistää minkä tahansa mallin Claudesta ja GPT:stä Ollaman kautta käytettävään paikalliseen malliin. Projektin GitHub-repositorio on jo ylittänyt kahdensadantuhannen tähden rajan. Ilmaus ”ilmainen Claude Code millä tahansa mallilla” kuulostaa houkuttelevalta, mutta vaatii täsmennystä: työkalu on ilmainen, mutta käyttöehdot riippuvat valitsemastasi mallista.

Alla on kaikki virallisen dokumentaation mukaan: mikä työkalu on, miten se asennetaan macOS-, Linux- tai Windows-käyttöjärjestelmään, miten malli yhdistetään ja mitä ensimmäisellä käynnistyskerralla tehdään. Kustannuksille on oma osionsa, koska ”ilmainen” koskee tässä vain työkalua: mallit maksavat, ja se aiheuttaa useimmiten sekaannusta.

Käytännön tietoja Ailootin käytöstä on dokumentaatiossa.

Mikä OpenCode on yksinkertaisesti selitettynä?#

Lyhyesti sanottuna OpenCode tekee saman kuin Claude Code: se ottaa vastaan tavallisella kielellä kirjoitetun tehtävän ja toteuttaa sen projektissasi. Ne eroavat kahdella tavalla. Koodi on täysin avointa, joten voit lukea ja tarkastella sitä. Työkalua ei myöskään ole sidottu yhteen mallipalveluntarjoajaan: se toimii yli 75 palveluntarjoajan kanssa Anthropicista ja OpenAI:sta laitteistollasi toimivaan paikalliseen malliin.

Projektia kehittää Anomaly-tiimi. Repositorio luotiin 30. huhtikuuta 2025, ja 4. lokakuuta 2026 sillä on yli 211 tuhatta tähteä ja 28 tuhatta forkia (varmistettu GitHub API -pyynnöllä). Ohjelmointikieli on TypeScript. Dokumentaatiota päivitetään jatkuvasti, joten alla olevat ohjeet perustuvat nykyiseen versioon.

Älä sekoita nimiä keskenään: nykyisen julkaisusarjan npm-paketin nimi on opencode-ai, repositorion nimi on anomalyco/opencode ja päätelaitteen komento on yksinkertaisesti opencode. Vanhemmissa artikkeleissa voi olla osoite sst/opencode: organisaatio vaihtoi nimeään, ja vanha linkki ohjaa nyt uuteen osoitteeseen.

Päivitetty 4. lokakuuta 2026: tiimi julkaisi OpenCode 2.0:n, työkalun seuraavan merkittävän sukupolven. Alla olevat asennus- ja mallin yhdistämisohjeet koskevat edelleen nykyistä 1.x-sarjaa (se asennetaan komennolla curl -fsSL https://opencode.ai/install | bash; nykyinen versio 30. syyskuuta 2026 on 1.18.34): sitä tuetaan aktiivisesti, ja se on versio, jonka opencode.ai/docs-sivuston virallinen dokumentaatio asentaa. Toisen version tarkat muutokset ja se, milloin kannattaa siirtyä siihen, käsitellään alla erillisessä osiossa.

Miten OpenCode eroaa Claude Codesta ja Codexista?#

Jos sinulla on jo Claude-tilaus, Claude Coden pitäminen päätyökalunasi on järkevää – meillä on siitä yksityiskohtainen asennusopas. OpenCode on sopiva vaihtoehto kolmessa tapauksessa: haluat työskennellä ChatGPT Plus- tai GitHub Copilot -tilauksen kautta, käyttää paikallista mallia ilman API-laskuja tai käyttää useita malleja saman käyttöliittymän kautta. Meillä on myös Codexin arvostelu ja asennusopas.

Jos et ole vielä valinnut työkalua, aloita tästä katsauksesta: millaisilla työkaluilla ihmiset koodaavat vuonna 2026. Jos olet jo asentanut OpenCoden ja haluat yhdistää sen muihin agentteihin Devin Desktopissa ACP:n kautta, katso oppaamme kyseiseen määritykseen.

Mitä OpenCode 2.0:ssa muuttui?#

Toinen versio asennetaan komennolla curl -fsSL https://opencode.ai/v2/install | bash. Virallisen siirtymisoppaan (opencode.ai/v2/docs/migrate-v1) mukaan molemmat versiot käyttävät samaa opencode-komentoa, eikä niitä enää oletusarvoisesti asenneta rinnakkain: v2-asennusohjelma korvaa v1-binääritiedoston, ja dokumentaatio pyytää nimenomaisesti poistamaan version v1 ennen v2:n asentamista paketinhallinnan kautta. Määritys luetaan kuitenkin samoista tiedostoista – ~/.config/opencode/ ja <project>/.opencode/ – joten asetukset, agentit ja MCP-palvelimet siirtyvät ilman uudelleenkirjoitusta. Kolme asiaa on kirjoitettava uudelleen: liitännäiset (niiden API on uusi), palvelin-API:n integraatiot (protokolla on muuttunut) ja päätelaitteen asetukset (nyt käytössä on yksi yhteinen cli.json-tiedosto useiden tui.json-tiedostojen sijaan).

V2:n kaksi huomattavinta uutta ominaisuutta ovat seuraavat. Ensinnäkin käyttöön tuli Console, maksullinen palvelu tiimeille, jossa on käytön seuranta, budjetit ja kaikille jäsenille yhteiset käytännöt. Toiseksi tiimi ilmoitti viimein Go-tilauksen hinnan: $10 kuukaudessa Go-versiosta ja $40 kuukaudessa Go Plus -versiosta, jossa on korkeammat rajat (opencode.ai/go-sivu, tarkistettu 4. lokakuuta 2026). Aiemmin dokumentaatiossa sanottiin vain ”edullinen tilaus” ilmoittamatta summaa.

Jos olet uusi käyttäjä ja haluat vain asentaa agentin, noudata alla olevia ohjeita. Ne koskevat nykyistä ensimmäistä versiota, jota dokumentaatio itse suosittelee. Harkitse v2:ta, jos tarvitset uusia liitännäisominaisuuksia tai tiimien Console-palvelua, mutta varaudu kirjoittamaan vanhempia liitännäisiä uudelleen uutta API:a varten. Jos etsit mieluummin avoimen lähdekoodin työpöytäsovellusta, joka ei vaadi päätelaitetta, tutustu ZCoden arvosteluumme. Se on toinen samankaltainen agentti, jolla on oma käyttöliittymä.

Mitä tarvitset ennen asennusta?#

Hieman lisää päätelaitteesta, koska se on ainoa vaihe, jossa asennus ei ehkä suju suunnitelmien mukaan. OpenCode näyttää päätelaitteessa kokonaisen käyttöliittymän paneeleineen ja korostuksineen, minkä vuoksi dokumentaatio suosittelee nykyaikaista emulaattoria. Jos käyttöliittymä näyttää käynnistyksen jälkeen väärältä, asenna ensin yksi neljästä mainitusta vaihtoehdosta: WezTerm (toimii kaikissa järjestelmissä), Alacritty, Ghostty tai Kitty. Windowsissa ensisijainen vaihtoehto on WSL, jota käsitellään erillisessä osiossa alempana.

Toinen tarvittava asia on malli. OpenCode toimii yhdistämäsi mallin kautta: yksinään se ei käsittele pyyntöjä. Vaihtoehtoja on neljä: tilaus (ChatGPT Plus, GitHub Copilot, GitLab Duo), minkä tahansa palveluntarjoajan API-avain, OpenCode Zen eli tiimin oma aggregaattori tai paikallinen malli Ollaman kautta. Kaikkia neljää vaihtoehtoa käsitellään mallin yhdistämistä koskevassa osiossa.

Ilman projektikuvausta agentin täytyy arvata build-komennot, tiedostorakenne ja käytössä olevat käytännöt – tästä syntyvät ”hallusinaatiot”. OpenCode käyttää tähän AGENTS.md-tiedostoa. Sama lähestymistapa toimii Claude Coden ja muiden agenttien kanssa; vain ohjetiedoston nimi muuttuu.

Miten OpenCode asennetaan macOS- ja Linux-käyttöjärjestelmiin?#

Suositeltu tapa on virallinen asennusohjelma:

1. Suorita asennusohjelma

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

   Skripti tunnistaa järjestelmäsi ja lataa OpenCoden. Jos komentoa ei löydy asennuksen jälkeen, sulje pääte ja avaa se uudelleen; uusi istunto löytää polun.

2. Tarkista, että asennus onnistui

   opencode --version
   

   Komento palauttaa versionumeron, mikä tarkoittaa, että asennus onnistui. Jos vastaus on ”command not found”, palaa ensimmäiseen vaiheeseen: käynnistä uusi pääteistunto tai muokkaa PATH-ympäristömuuttujaa manuaalisesti.

Jos haluat hallita paketteja itse, vaihtoehdot ovat seuraavat:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Homebrew-komento alkaa tarkoituksella merkkijonolla anomalyco/tap/: dokumentaatio suosittelee heidän omaa tap-arkistoaan, koska Homebrew-tiimi päivittää brew install opencode -komennon kaavaa harvemmin. Sama paketti opencode-ai toimii myös bunin, pnpm:n ja yarnin kanssa (bun install -g opencode-ai, yarn global add opencode-ai). Arch Linuxissa käytä vakaasta ohjelmistovarastosta komentoa sudo pacman -S opencode tai AUR:n uusimman version asentamiseen komentoa paru -S opencode-bin.

Päivitä OpenCode komennolla opencode upgrade; käynnistyessään se lataa päivitykset myös itse, jos automaattinen päivitys on käytössä. Tarkista päivityksen jälkeen versio tutulla komennolla opencode --version. Myös asennuksen poistaminen onnistuu sisäänrakennetulla toiminnolla:

opencode uninstall

Komento näyttää tarkalleen, mitä poistetaan, ja pyytää vahvistusta. Voit halutessasi säilyttää määritykset ja istuntotiedot käyttämällä valitsimia --keep-config ja --keep-data.

Miten OpenCode asennetaan Windowsiin?#

Kehittäjien itsensä suosittelema ensimmäinen vaihtoehto on WSL. Asenna se yhdellä komennolla järjestelmänvalvojana käynnistetyssä PowerShellissä:

wsl --install

Käynnistä tietokone uudelleen, avaa Ubuntu Käynnistä-valikosta ja suorita siellä tuttu komento:

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

Windows-asemien tiedostot ovat käytettävissä WSL:ssä polun /mnt/ kautta: C:-asema löytyy polusta /mnt/c/ ja D:-asema polusta /mnt/d/. Siksi projektin C:\Users\Name\project voi avata näin:

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

Toinen vaihtoehto on ohittaa WSL ja käyttää Windowsin paketinhallintaohjelmia. Suorita PowerShellissä:

choco install opencode

scoop install opencode

Kolmas vaihtoehto on työpöytäsovellus ja verkkoversio. Sovellus asentuu tavallisen ohjelman tapaan ja näyttää käyttöliittymän ikkunassa ilman päätelaitetta. Verkkoversion käynnistää komento opencode web: se avaa OpenCoden selaimessa. Dokumentaatio suosittelee käynnistämään sen WSL:stä myös tiedostojen käyttöön liittyvien ongelmien välttämiseksi. Dokumentaatiossa luetellaan myös harvinaisempia vaihtoehtoja: mise, Docker ja valmis binääritiedosto GitHubin julkaisut-sivulta. Asennusta bunin kautta Windowsissa vielä kehitetään; jos bun on ensisijainen paketinhallintaohjelmasi, käytä npm-vaihtoehtoa.

Miten malli yhdistetään OpenCodeen?#

OpenCode tukee yli 75 palveluntarjoajaa AI SDK:n ja Models.dev:n kautta sekä paikallisia malleja. Useimmat yhdistetään käyttöliittymän /connect-komennolla; paikallisia malleja varten palvelimen osoite määritetään myös asetuksissa. Vaihtoehdot eroavat maksutavan ja tietokoneen vaatimusten osalta:

Dokumentaatio suosittelee aloittelijoita aloittamaan OpenCode Zenillä. Tiimi valitsi mallit, jotka toimivat hyvin nimenomaan agentteina, ja testasi niiden ja palveluntarjoajien yhdistelmiä omissa tehtävissään.

Yhdistäminen tapahtuu näin: kirjoita /connect, valitse OpenCode Zen, kirjaudu sisään ja lisää maksutapa osoitteessa opencode.ai/auth, hanki avain ja liitä se. Sen jälkeen /models näyttää suositeltujen mallien luettelon. 4. lokakuuta 2026 luettelossa ovat esimerkiksi GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 ja Kimi K2.5. Dokumentaatiossa varoitetaan avoimesti, ettei luettelo ole kattava ja että se vanhenee nopeasti, koska uusia malleja julkaistaan joka viikko.

Tilaukset yhdistetään samalla /connect-komennolla: valitse luettelosta ChatGPT Plus tai GitHub Copilot ja kirjaudu tilillesi. Muita määrityksiä ei tarvita.

Jos valitset Anthropicin, /connect tarjoaa kaksi vaihtoehtoa: voit syöttää API-avaimen manuaalisesti tai valita Claude Pro/Maxin ja tunnistautua selaimen kautta. Anthropic kuitenkin kieltää kolmannen osapuolen liitännäiset, joilla käytetään Claude Pro/Max -tilausta, ja tämän tyyppiset sisäänrakennetut liitännäiset poistettiin OpenCodesta versiosta 1.3.0 alkaen. Jos löydät vanhemman artikkelin aiheesta ”OpenCode Claude-tilauksella”, siinä viitataan poistettuihin liitännäisiin, ei viralliseen valtuutukseen. ChatGPT Plus-, GitHub Copilot-, GitLab Duo- (merkitty kokeelliseksi) ja Atomic Chat -tilaukset toimivat ilman lisämäärityksiä.

OpenCode tallentaa /connect-komennolla antamasi avaimet tiedostoon ~/.local/share/opencode/auth.json. Jos et halua valita mallia joka kerta, aseta oletusmalli projektin juuressa olevaan opencode.json-määritystiedostoon:

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

Muoto on provider/model; molemmat tunnisteet näkyvät /models-komennon tulosteessa.

Miten paikallinen malli yhdistetään Ollaman kautta?#

Tässä vaihtoehdossa API-laskuja ei tule lainkaan: malli toimii tietokoneellasi. Jos valitset yleisesti ilmaisista malleista, meillä on erillinen arvostelu siitä, mitkä toimivat kohtuullisesti agentteina ja mitkä vain paperilla. Asenna OpenCodea varten Ollama viralliselta sivustolta ja lataa malli:

ollama pull qwen3-coder

Dokumentaatiossa mainitaan hyödyllinen yksityiskohta: Ollama voi määrittää itsensä OpenCodea varten automaattisesti; sitä varten on erillinen integrointiopas. Jos haluat tehdä kaikki määritykset käsin, lisää opencode.json-tiedostoon palveluntarjoaja, jonka osoitteena on paikallinen Ollama-palvelimesi:

{
  "$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"
        }
      }
    }
  }
}

Tämän jälkeen paikallinen malli näkyy käyttöliittymän /models-luettelossa. Valitse se ja aloita työskentely. Dokumentaation käytännön huomautus: jos agentti lakkaa kutsumasta työkaluja (muokkaamasta tiedostoja tai suorittamasta komentoja), suurenna num_ctx-arvoa Ollaman asetuksissa – aloita arvoista 16k–32k. Paikalliset mallit ovat pilvimalleja heikompia nimenomaan agenttityössä, ja pieni konteksti pahentaa tätä. Jos paikallinen versio ei riitä, voit yhdistää Qwenin pilvipalvelusta avaimella; oppaassa Qwen Coden API-avaimen hankkiminen kerrotaan, mistä sellaisen saa.

Paljonko OpenCode ja sen käyttö maksavat?#

Kaikki tässä mainitut kustannukset koskevat mallia, ja vaihtoehtoja on neljä. API-avaimella tai Zenillä maksat todellisesta käytöstä, ja summa riippuu siitä, kuinka paljon agentti työskentelee. Go on OpenCode-tiimin avoimille malleille tarkoitettu tilaustaso: $10 kuukaudessa Go-versiosta ja $40 kuukaudessa Go Plus -versiosta, jossa on korkeammat rajat (tarkistettu opencode.ai/go-sivulta 4. lokakuuta 2026). Raja riippuu mallista: Go sallii esimerkiksi Kimi K3:lla noin 110 pyyntöä 5 tunnissa (440 kuukaudessa) ja kevyemmällä DeepSeek V4.1 Flashilla noin 26 000 pyyntöä 5 tunnissa. Dokumentaatiossa ilmoitetaan erillinen hinta, jos tiettyä mallia käytetään rajan yli ($15 kuukaudessa Kimi K3:sta ja $60 Go Plus -versiosta). Kun yhdistät palvelun, katso tilaussivulta mallien ja rajojen täydellinen luettelo. ChatGPT Plus- tai Copilot-tilauksella pyynnöt sisältyvät jo maksamaasi tilaukseen, mutta muista, että tilauksissa on omat käyttörajansa. Paikalliselle mallille Ollaman kautta tehdyt pyynnöt eivät lopuksi maksa mitään, mutta tarvitset riittävän tehokkaan tietokoneen, jotta malli toimii nopeasti.

Mitä ensimmäisellä käynnistyskerralla kannattaa tehdä?#

Ensimmäinen käynnistys projektikansion sisältä:

cd path/to/project
opencode

Käyttöliittymä avautuu syöttökenttään. Käytä ensin komentoa /init: agentti etsii tärkeät repositoriotiedostot, esittää tarvittaessa pari kysymystä ja kirjoittaa AGENTS.md-tiedoston. Siinä kuvataan projektin rakenne, build- ja testauskomennot sekä käytetyt käytännöt. Dokumentaatio suosittelee viemään tämän tiedoston gitiin; tämän jälkeen OpenCode käyttää sitä pysyvänä projektiohjeena. AGENTS.md vastaa tarkoitukseltaan suoraan CLAUDE.md:tä OpenCode-ekosysteemissä.

Käytä seuraavaksi Plan-tilaa. Tab-näppäimellä vaihdat kahden pääagentin välillä: Build käsittelee tiedostoja ja komentoja täydellä käyttöoikeudella, kun taas Plan on analysointia ja suunnittelua varten – Plan-tilassa tiedostojen muokkaaminen ja bash-komennot vaativat oletusarvoisesti hyväksyntäsi. Dokumentaatio suosittelee aloittamaan uudet tehtävät suunnitelmalla: lue, mitä agentti aikoo tehdä, muokkaa sanamuotoa ja vaihda vasta sitten Tab-näppäimellä takaisin Build-tilaan.

Dokumentaatio neuvoo näin:

Mitä tarkempi tehtävä ja mitä enemmän annat kontekstia, sitä vähemmän työtä joudut tekemään uudelleen. Lisää tiedostoja pyyntöön merkillä @: ala kirjoittaa nimeä, niin käyttöliittymä löytää tiedostot sumealla haulla. Voit vetää kuvia suoraan päätelaitteeseen, ja !-merkillä alkava viesti suoritetaan shell-komentona; sen tuloste lisätään agentin kontekstiin. Jos teit tehtävän kuvauksessa virheen tai agentti teki väärin, /undo kumoaa muutokset. Komennon voi suorittaa useita kertoja peräkkäin. Muutitko vielä kerran mielesi? /redo palauttaa kumotut muutokset. /share luo linkin keskusteluun tiimiäsi varten; ilman tätä komentoa keskustelua ei julkaista minnekään.

Mitä muuta OpenCode osaa?#

Mukautetut komennot. Toistuvasta pyynnöstä voi tehdä komennon: lisää Markdown-tiedosto .opencode/commands/-kansioon, määritä sen frontmatterissa description, agent ja model ja kirjoita alle prompt-malli. Suorita sitten komento merkillä /. Esimerkiksi projektin tarkistukset ennen julkaisua, viimeaikaisten virheiden tarkastelu tai migraation luominen – mitä tahansa pyydät säännöllisesti.

Aliagentit. Buildin ja Planin lisäksi käytettävissä on kolme muuta agenttia: General monivaiheisiin tehtäviin (pääsy kaikkiin työkaluihin tehtäväluetteloa lukuun ottamatta), Explore koodin nopeaan lukemiseen ilman muokkausoikeutta ja Scout ulkoisten kirjastojen tutkimiseen. Kutsu niitä mainitsemalla ne viestissä @-merkillä.

MCP-palvelimet. Yhdistä ulkoisia työkaluja opencode.json-määritystiedoston mcp-osion kautta. Sekä paikallisia että etäpalvelimia tuetaan. Jokainen MCP-palvelin lisää työkalunsa kontekstiin, ja vaativa palvelin, kuten GitHub, voi täyttää kontekstin nopeasti – yhdistä harkiten ja vain tarvitsemasi palvelimet. Meillä on valmiita määrityksiä sisältävä opas MCP-konseptista. Se käsittelee Claude Codea, mutta protokolla on yhteinen.

Verkkoversio ja palvelin. opencode web avaa käyttöliittymän selaimessa. Jos haluat käyttää palvelua toiselta tietokoneelta, käytä komentoa opencode serve --hostname 0.0.0.0 --port 4096; kun verkkoyhteys on käytössä, aseta ehdottomasti salasana muuttujalla OPENCODE_SERVER_PASSWORD. Ilman salasanaa palvelin ei ole suojattu.

Mitä tehdä, jos asennus menee pieleen?#

”opencode: command not found” asennuksen jälkeen. Pääte ei vielä tunnista uutta polkua. Sulje pääte ja avaa se uudelleen. Jos se ei auta, selvitä, minne asennusohjelma sijoitti binääritiedoston, ja lisää kyseinen kansio päätteen PATH-muuttujaan.

Malli ei vastaa tai ilmoittaa valtuutusvirheestä. Tarkista, että palveluntarjoaja on yhdistetty: kirjoita /connect ja tunnistaudu uudelleen. Avaimet tallennetaan tiedostoon ~/.local/share/opencode/auth.json. Jos siirsit asennuksen toiselta tietokoneelta tai tyhjensit kansioita, tiedosto voi puuttua. Dokumentaatiossa ProviderInitError- ja AI_APICallError-virheitä käsitellään erikseen: ensimmäisessä tapauksessa valtuuta palveluntarjoaja uudelleen; toisessa tyhjennä kansio ~/.cache/opencode ja käynnistä uudelleen.

Käyttöliittymä on rikki: paneelit ovat sekaisin tai symbolien tilalla näkyy lukukelvottomia merkkejä. Tarkista ensin pääte. Asenna jokin suositelluista vaihtoehdoista – WezTerm toimii kaikissa kolmessa järjestelmässä – ja käynnistä OpenCode siitä.

Jos mikään ei auta, tarkista lokit: macOS- ja Linux-käyttöjärjestelmissä ne ovat hakemistossa ~/.local/share/opencode/log/; Windowsissa paina Win+R ja anna poluksi %USERPROFILE%\.local\share\opencode\log. Järjestelmä säilyttää kymmenen viimeisintä tiedostoa. Ota yksityiskohtainen lokitus käyttöön valitsimella opencode --log-level DEBUG. Näiden lokien avulla voit tehdä virheraportin projektin GitHub-repositorioon.

Mitä muuta OpenCodesta kysytään?#

Avaa Ailoot.