# OpenCode: asennus, mallit ja ensimmäinen käynnistys > Asennus macOS-, Linux- ja Windows-käyttöjärjestelmiin, OpenCode 1.x ja 2.0, palveluntarjoajien ja Ollaman yhdistäminen, määritys, kustannukset ja vianmääritys. Source: https://ailoot.ai/blog/fi/opencode-installation-models/ Canonical: https://ailoot.ai/blog/fi/opencode-installation-models/ Language: fi Publisher: Ailoot (https://ailoot.ai/) Translation: guide-190 Revision: sha256-2a03cdced3f950adbd9cd89ea25c87da0007f712489efe88d7a010924e553068 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](https://ailoot.ai/docs/). ## Mikä OpenCode on yksinkertaisesti selitettynä?
Tärkeimmät kohdat OpenCode on Anomaly-tiimin kehittämä avoimen lähdekoodin tekoälykoodausagentti (MIT-lisenssi). Se toimii päätelaitteessa, ja se on saatavilla myös työpöytäsovelluksena, editorilaajennuksena ja verkkoversiona. Kerrot sille, mitä projektissa pitää tehdä, ja agentti lukee tiedostoja, muokkaa koodia ja suorittaa komentoja itsenäisesti. Itse työkalu on ilmainen; yhdistät siihen oman mallisi, joka voi toimia pilvessä tai paikallisesti.
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](https://github.com/anomalyco/opencode) (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?
Tärkeimmät kohdat Claude Code toimii vain Anthropicin malleilla. Codex on OpenAI-agentti, joka on sidottu ChatGPT-ekosysteemiin. OpenCode on avoin työkalu, joka ei sido tiettyyn palveluntarjoajaan: se on ilmainen, ja voit valita mallin yli 75 palveluntarjoajalta. Niihin kuuluvat ChatGPT Plus- ja GitHub Copilot -tilaukset sekä paikalliset mallit.
| Ominaisuus | OpenCode | Claude Code | Codex | |----|----|----|----| | Koodi | Avoin, MIT | Suljettu | Avoin | | Mallit | Yli 75 palveluntarjoajaa ja paikallisia malleja | Vain Claude | OpenAI-mallit | | Työkalun hinta | Ilmainen | Tilaus tai tokenit | ChatGPT-tilaus tai tokenit | | Tilauskäyttö | ChatGPT Plus, GitHub Copilot, GitLab Duo | Claude Pro/Max (oma tilaus) | ChatGPT (oma tilaus) | | Käyttöympäristö | Pääte, työpöytä, editori, selain | Pääte ja editori | Pääte, verkko, editori | | Projektin määritystiedosto | AGENTS.md | CLAUDE.md | AGENTS.md | Jos sinulla on jo Claude-tilaus, Claude Coden pitäminen päätyökalunasi on järkevää – meillä on siitä [yksityiskohtainen asennusopas](https://ailoot.ai/blog/fi/install-claude-code/). 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](https://ailoot.ai/blog/fi/openai-codex-install/). Jos et ole vielä valinnut työkalua, aloita tästä katsauksesta: [millaisilla työkaluilla ihmiset koodaavat vuonna 2026](https://ailoot.ai/blog/fi/ai-coding-tools/). Jos olet jo asentanut OpenCoden ja haluat yhdistää sen muihin agentteihin Devin Desktopissa ACP:n kautta, katso [oppaamme kyseiseen määritykseen](https://ailoot.ai/blog/fi/codex-claude-agent-opencode-devin-desktop-acp/). ## Mitä OpenCode 2.0:ssa muuttui?
Tärkeimmät kohdat OpenCode 2.0 on ollut saatavilla osoitteessa opencode.ai 4. lokakuuta 2026 alkaen. Siinä on oma asennusohjelma ja uusi npm-paketti `@opencode/cli`. Ensimmäinen versio, jonka tämä artikkeli asentaa, ei ole kadonnut: dokumentaatiossa on sille erillinen `V1`-haara, sitä tuetaan aktiivisesti ja se on edelleen oletusvalinta. Kehittäjät eivät ole tarkoituksella säilyttäneet yhteensopivuutta ensimmäisen version kanssa kolmella alueella: liitännäis-API:ssa, palvelinprotokollassa ja päätelaitteen asetustiedostossa.
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 `/.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](https://ailoot.ai/blog/fi/zcode-korvaaja-claude-codelle/). Se on toinen samankaltainen agentti, jolla on oma käyttöliittymä. ## Mitä tarvitset ennen asennusta?
Tärkeimmät kohdat Tarvitset kaksi asiaa: nykyaikaisen pääte-emulaattorin (dokumentaatiossa mainitaan WezTerm, Alacritty, Ghostty tai Kitty) ja pääsyn malliin – palveluntarjoajan API-avaimen, tuetun tilauksen tai paikallisen mallin Ollaman kautta. Mallia tarvitset asennuksen jälkeen: yhdistät sen ensimmäisellä käynnistyskerralla.
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?
Tärkeimmät kohdat Yksi komento päätelaitteessa: curl -fsSL \| bash. Dokumentaatiossa tätä kutsutaan yksinkertaisimmaksi menetelmäksi. Vaihtoehdot: brew install anomalyco/tap/opencode, npm install -g opencode-ai sekä Arch Linuxissa pacman tai paru.
Suositeltu tapa on virallinen asennusohjelma: 1. ### Suorita asennusohjelma ```bash 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 ```bash 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: ```bash brew install anomalyco/tap/opencode ``` ```bash 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: ```bash 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?
Tärkeimmät kohdat Dokumentaatio suosittelee WSL:ää suorituskyvyn ja täyden yhteensopivuuden vuoksi: asenna Windows Subsystem for Linux ja asenna sitten OpenCode sen sisälle tavallisella Linux-komennolla. Ilman WSL:ää voit käyttää Chocolateyta (`choco install opencode`), Scoopia (`scoop install opencode`), npm:ää tai työpöytäsovellusta.
Kehittäjien itsensä suosittelema ensimmäinen vaihtoehto on WSL. Asenna se yhdellä komennolla järjestelmänvalvojana käynnistetyssä PowerShellissä: ```powershell wsl --install ``` Käynnistä tietokone uudelleen, avaa Ubuntu Käynnistä-valikosta ja suorita siellä tuttu komento: ```bash 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: ```bash cd /mnt/c/Users/Name/project opencode ``` Toinen vaihtoehto on ohittaa WSL ja käyttää Windowsin paketinhallintaohjelmia. Suorita PowerShellissä: ```powershell choco install opencode ``` ```powershell 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?
Tärkeimmät kohdat Kirjoita päätekäyttöliittymässä `/connect` ja valitse luettelosta palveluntarjoaja: OpenCode Zen, jos haluat päästä alkuun ilman omia avaimia, Anthropic tai OpenAI API-avaimella, ChatGPT Plus tai GitHub Copilot tilauksella tai Ollama paikallista mallia varten. Avaimet tallennetaan auth.json-tiedostoon; valitse tietty malli komennolla `/models`.
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: | Vaihtoehto | Mikä se on | Hinta | |----|----|----| | OpenCode Zen | OpenCode-tiimin testaama mallien aggregaattori | Maksat pyynnöittäin ja lisäät saldoa | | OpenCode Go | Tiimin avoimille malleille tarkoitettu tilaustaso | \$10 kuukaudessa (Go) tai \$40 kuukaudessa (Go Plus, korkeammat rajat) | | API-avain | Anthropic, OpenAI, Google, DeepSeek ja muut | Maksat palveluntarjoajalle käytön mukaan | | Tilaus | ChatGPT Plus, GitHub Copilot, GitLab Duo | Jo maksettu | | Ollama / LM Studio | Paikallinen malli omalla laitteistollasi | Ei API-laskuja, mutta tarvitset riittävän tehokkaan tietokoneen | 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: ```json { "$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ärkeimmät kohdat Asenna Ollama osoitteesta ollama.com ja lataa malli komennolla `ollama pull` – Ollama voi määrittää itsensä automaattisesti OpenCodea varten. Manuaalisesti voit lisätä palveluntarjoajan `opencode.json`-tiedostoon ja määrittää paikallisen palvelimen osoitteeksi . Valitse malli komennolla `/models`. Jos agentti ei kutsu työkaluja, suurenna Ollaman `num_ctx`-arvoksi 16k–32k.
Tässä vaihtoehdossa API-laskuja ei tule lainkaan: malli toimii tietokoneellasi. Jos valitset yleisesti ilmaisista malleista, meillä on [erillinen arvostelu](https://ailoot.ai/blog/fi/free-coding-models/) siitä, mitkä toimivat kohtuullisesti agentteina ja mitkä vain paperilla. Asenna OpenCodea varten Ollama viralliselta sivustolta ja lataa malli: ```bash 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: ```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" } } } } } ``` 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](https://ailoot.ai/blog/fi/qwen-code-api-key/) kerrotaan, mistä sellaisen saa. ## Paljonko OpenCode ja sen käyttö maksavat?
Tärkeimmät kohdat OpenCode itsessään on ilmainen: sen lähdekoodi on julkaistu MIT-lisenssillä. Maksat vain mallista: käytön mukaan API-avaimella tai Zenillä, Go-tilauksella tai jo maksamallasi ChatGPT Plus- tai Copilot-tilauksella – tai et lainkaan, sillä paikalliselle mallille Ollaman kautta tehdyt pyynnöt ovat maksuttomia.
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ä?
Tärkeimmät kohdat Siirry projektikansioon, suorita opencode ja käytä komentoa `/init` – agentti tutkii projektin ja luo sitä kuvaavan AGENTS.md-tiedoston. Ennen muokkaamista paina Tab-näppäintä ja vaihda Plan-tilaan: agentti ehdottaa ratkaisua ja näyttää muutokset hyväksyttäväksesi. Kumoa virheelliset toiminnot komennolla `/undo`.
Ensimmäinen käynnistys projektikansion sisältä: ```bash 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:

Siitä on apua, kun puhut sille samalla tavalla kuin puhuisit tiimisi nuoremmalle kehittäjälle.

— OpenCoden virallinen dokumentaatio, https://opencode.ai/docs/
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?
Tärkeimmät kohdat Mukautetut komennot `.opencode/commands`-kansion Markdown-tiedostoista, aliagentit rinnakkaisiin tehtäviin ja koodin lukemiseen, MCP-palvelimet ulkoisille työkaluille, selainkäyttöinen verkkoversio ja palvelintila etätyötä varten.
**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](https://ailoot.ai/blog/fi/mcp-servers-claude-code/) 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?
Tärkeimmät kohdat Lähes kaikki ongelmat johtuvat kolmesta asiasta: `opencode`-komentoa ei löydy (käynnistä uusi pääteistunto tai muokkaa PATH-muuttujaa), malli ei vastaa (tarkista `/connect`-komennon avain ja `auth.json`-tiedosto) tai käyttöliittymä näkyy väärin (käytä nykyaikaista päätettä, kuten WezTermiä). Aloita vianmääritys lokitiedostoista hakemistossa `~/.local/share/opencode/log/`.
**”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?
Tärkeimmät kohdat Lyhyet vastaukset yleisiin kysymyksiin: OpenCode on ilmainen työkalu, ja maksat vain mallista. Claude Pro/Max yhdistetään komennolla `/connect`, ja kolmannen osapuolen liitännäiset tätä varten ovat kiellettyjä. Palvelua voi käyttää puhelimella verkkoversion kautta. OpenCode päivitetään komennolla `opencode upgrade`.
### Usein kysytyt kysymykset Onko OpenCode ilmainen? Kyllä, sen lähdekoodi on julkaistu MIT-lisenssillä. Mallista voi joutua maksamaan; kaikki vaihtoehdot käsitellään edellä kustannuksia koskevassa osiossa. Voinko yhdistää Claude Pro/Max -tilauksen? Kyllä. Anthropic tarjoaa virallisen Claude Pro/Max -vaihtoehdon `/connect`-komennossa, ja tunnistautuminen tapahtuu selaimessa. Vanhat artikkelit Claude-tilauksen käytöstä liitännäisten kautta ovat vanhentuneita: Anthropic kieltää kyseiset liitännäiset, ja ne on poistettu OpenCodesta versiosta 1.3.0 alkaen. Voiko OpenCodea käyttää puhelimella? Toimiva vaihtoehto on verkkoversio: suorita `opencode serve` tietokoneella tai palvelimella ja yhdistä sitten puhelimen selaimella. Kaikki verkkoyhteydet edellyttävät salasanaa, `OPENCODE_SERVER_PASSWORD`. Miten OpenCode on Claude Codea parempi? Se riippuu malleistasi ja tilauksistasi: Claude Code integroituu Anthropicin malleihin, kun taas OpenCode tarjoaa yli 75 palveluntarjoajaa, avointa lähdekoodia ja paikallisia malleja. Katso yllä olevasta taulukosta täydellinen vertailu. Kannattaako OpenCode 2.0 asentaa heti? Ei välttämättä. Dokumentaatio suosittelee oletusarvoisesti nykyistä ensimmäistä versiota – tässä oppaassa asennetaan sillä komennolla curl -fsSL https://opencode.ai/install \| bash. Toinen versio on ollut saatavilla 4. lokakuuta 2026 lähtien, mutta liitännäiset ja palvelin-API:n integraatiot toimivat siinä eri tavalla, ja osa koodista täytyy kirjoittaa uudelleen.
### Lähteet - [OpenCode, virallinen dokumentaatio](https://opencode.ai/docs/) - [Mallipalveluntarjoajat](https://opencode.ai/docs/providers/) - [Mallien valinta ja määritys](https://opencode.ai/docs/models/) - [OpenCode Zen](https://opencode.ai/docs/zen/) - [Agentit ja aliagentit](https://opencode.ai/docs/agents/) - [AGENTS.md-sääntötiedosto](https://opencode.ai/docs/rules/) - [Mukautetut komennot](https://opencode.ai/docs/commands/) - [MCP-palvelimet](https://opencode.ai/docs/mcp-servers/) - [OpenCode Windowsissa WSL:n kautta](https://opencode.ai/docs/windows-wsl) - [Päätekäyttöliittymä](https://opencode.ai/docs/tui/) - [Verkkoversio](https://opencode.ai/docs/web/) - [Vianmääritys](https://opencode.ai/docs/troubleshooting/) - [Komentorivi](https://opencode.ai/docs/cli/) - [OpenCoden GitHub-repositorio](https://github.com/anomalyco/opencode) - [OpenCode 2.0: siirtyminen versiosta 1](https://opencode.ai/v2/docs/migrate-v1/) - [OpenCode Go: tilaustasot ja rajat](https://opencode.ai/go)
[Avaa Ailoot](https://ailoot.ai/). ## Kysymyksiä tästä oppaasta: OpenCode: asennus, mallit ja ensimmäinen käynnistys ### Miksi OpenCoden asentaminen ei vielä anna toimivaa mallia? Työkalu ja mallin käyttöoikeus ovat eri asioita. Yhdistä palveluntarjoaja, tuettu tilaus tai paikallinen malli komennolla /connect, valitse malli komennolla /models ja varmista toiminta rajatulla oman projektin tehtävällä. ### Mitä pitää tarkistaa ennen OpenCode 1.x:n vaihtamista 2.0:aan? Tarkista lisäosien, palvelin-API-integraatioiden ja terminaaliasetusten yhteensopivuus. Varmista asennettu versio sekä säilytä asetukset ja istunnot ennen ohjelmatiedoston korvaamista. ## Ailoot · Yritys ja sen projektisalkku Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan. Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.