Keskeiset asiat

• Useita asennustapoja: npm, Homebrew, curl-skripti, Go-asennus, Docker ja rakentaminen lähdekoodista -- valitse se, joka sopii parhaiten työkaluketjuusi.
• 5 minuuttia ensimmäiseen ajoon: Nopein tapa (curl-asennusskripti) saa OpenCode-ohjelman käyntiin alle 5 minuutissa missä tahansa Unix-järjestelmässä.
• Tarjoajasta riippumaton: OpenCode toimii OpenAI, Google Gemini, Ollama-paikallismallien ja muiden kanssa -- et ole sidottu yhteen AI-tarjoajaan.
• Konfigurointi on minimaalista: Yksi config.toml-tiedosto ja yksi ympäristömuuttuja on kaikki mitä tarvitset aloittaaksesi koodauksen AI-avulla terminaalissasi.

Kuinka asentaa OpenCode: Vaiheittainen asennusopas (2026)

OpenCode on avoimen lähdekoodin AI-koodausagentti, joka on rakennettu terminaalia varten. Se tuo suurten kielimallien tehon suoraan komentorivillesi, antaen sinun kirjoittaa, refaktoroida, debugata ja ymmärtää koodia poistumatta editoristasi tai terminaalin työnkulusta.

Olitpa sitten asentamassa OpenCode-ohjelmaa ensimmäistä kertaa tai siirtymässä toisesta AI-koodaustyökalusta, tämä opas käy läpi jokaisen asennusmenetelmän, alkuasetukset, tarjoajien määritykset ja vianmääritysvaiheet, joita tulet tarvitsemaan.

---

Esivaatimukset

Ennen kuin asennat OpenCode-ohjelman, varmista, että järjestelmäsi täyttää seuraavat vaatimukset.

Käyttöjärjestelmä

OpenCode toimii macOS-, Linux- ja Windows-alustoilla. Windows-käyttäjille WSL (Windows Subsystem for Linux) on erittäin suositeltava. Natiivi Windows-tuki Scoopin kautta on myös saatavilla.

Ajonikaiset vaatimukset (riippuvat asennustavasta)

Asennustapa	Vaatimus
npm	Node.js 18 tai uudempi
Homebrew	macOS tai Linux, jossa on Homebrew asennettuna
Curl-skripti	bash, curl
Go-asennus	Go 1.22 tai uudempi
Docker	Docker Engine 20+
Rakenna lähdekoodista	Go 1.22+, Git

Terminaalivaatimukset

OpenCode tarjoaa TUI-rajapinnan (Terminal User Interface), joten terminaaliemulaattorisi on tuettava true color -värejä ja asianmukaista Unicode-renderöintiä. Useimmat nykyaikaiset terminaalit (iTerm2, Alacritty, WezTerm, Windows Terminal, Ghostty) toimivat suoraan. Vanhemmissa terminaaleissa, kuten macOS:n oletusarvoisessa Terminal.app-sovelluksessa, voi olla renderöintiongelmia.

Tarkista Node.js-versiosi:

node --version

Tarkista Go-versiosi (jos käytät Go-asennustapaa):

go version

---

Tapa 1: Asennusskripti (Nopein)

Virallinen asennusskripti on nopein tapa saada OpenCode käyntiin. Se tunnistaa käyttöjärjestelmäsi ja arkkitehtuurisi, lataa oikean binäärin ja sijoittaa sen PATH-polullesi.

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

Tämä yksi komento hoitaa kaiken. Kun se on valmis, varmista asennus:

opencode --version

Tämä menetelmä toimii macOS- ja Linux-järjestelmissä. Se ei vaadi Node.js- tai Go-asennusta.

---

Tapa 2: npm-asennus

Jos Node.js kuuluu jo työnkulkuusi, npm on tutuin vaihtoehto.

npm install -g opencode-ai@latest

Paketin nimi npm:ssä on opencode-ai, ei opencode. Tämä on yleinen sekaannuksen lähde.

Varmistaaksesi asennuksen:

opencode --version

Jos kohtaat käyttöoikeusvirheitä, korjaa joko npm:n globaalin hakemiston käyttöoikeudet tai käytä npx-komentoa ajaaksesi sen ilman globaalia asennusta:

npx opencode-ai@latest

---

Tapa 3: Homebrew (macOS ja Linux)

Homebrew-käyttäjät voivat asentaa OpenCode-ohjelman virallisesta hanasta:

brew install anomalyco/tap/opencode

Tämä asentaa uusimman vakaan julkaisun ja hoitaa päivitykset brew upgrade -komennon kautta.

Varmistaaksesi asennuksen:

opencode --version

---

Tapa 4: Go-asennus

Jos sinulla on Go 1.22+ asennettuna, voit asentaa ohjelman suoraan lähdekoodista go install -komennolla:

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

Varmista, että $GOPATH/bin (tai oletuksena $HOME/go/bin) on PATH-polullasi. Lisää se shell-profiiliisi, jos se ei vielä ole siellä:

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

Varmista:

opencode --version

---

Tapa 5: Docker

OpenCode-ohjelman ajaminen Dockerissa on hyödyllistä CI/CD-putkissa tai kun haluat eristetyn ympäristön.

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

Aja se projektihakemistosi ollessa liitettynä:

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

-it-liput ovat välttämättömiä, koska OpenCode käyttää interaktiivista TUI-rajapintaa. -v-lippu liittää nykyisen projektihakemistosi, jotta OpenCode voi lukea ja muokata tiedostojasi.

---

Tapa 6: Rakenna lähdekoodista

Kehittäjille tai kaikille, jotka haluavat uusimman kehitysversion:

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

Siirrä binääri PATH-polullasi olevaan hakemistoon:

sudo mv opencode /usr/local/bin/

Lähdekoodista rakentaminen vaatii Go 1.22+ ja Git -työkalut. Tämä antaa sinulle pääsyn julkaisemattomiin ominaisuuksiin ja antaa sinun muokata työkalua omiin tarpeisiisi.

---

Tapa 7: Scoop (Windows)

Windows-käyttäjät, jotka suosivat natiivikokemusta WSL:n sijaan, voivat käyttää Scoop-hallintaa:

scoop install opencode

Scoop hoitaa PATH-konfiguroinnin automaattisesti.

---

Ensimmäinen käynnistys ja konfigurointi

Kun OpenCode on asennettu, siirry mihin tahansa projektihakemistoon ja käynnistä se:

cd your-project
opencode

Ensimmäisellä käynnistyskerralla OpenCode avaa TUI-näkymänsä ja pyytää sinua yhdistämään AI-tarjoajan. Voit käyttää interaktiivista /connect-komentoa lisätäksesi API-avaimesi:

/connect

Tämä opastaa sinut valitsemaan tarjoajan (OpenAI, Google, Anthropic, jne.) ja syöttämään API-avaimesi. Tunnistetiedot tallennetaan polkuun ~/.local/share/opencode/auth.json.

Nopeampaa aloitusta varten voit myös alustaa projektisi komennolla:

/init

Tämä analysoi repon rakenteen ja luo agents.md-tiedoston, joka sisältää kontekstia koodistasi, auttaen AI-mallia antamaan tarkempia vastauksia heti alusta alkaen.

---

Määritä AI-tarjoajat

OpenCode tukee useita AI-tarjoajia. Tässä on ohjeet kunkin määrittämiseen.

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

Aseta API-avain ympäristömuuttujaksi:

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

Tai lisää se shell-profiiliisi (~/.zshrc, ~/.bashrc) pysyvyyttä varten.

Google Gemini (Gemini 2.5 Pro, Gemini 2.5 Flash)

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

Voit hankkia Google API -avaimen osoitteesta Google AI Studio.

Ollama (Paikalliset mallit -- Ilmainen, yksityinen)

Ollama antaa sinun ajaa malleja paikallisesti ilman API-avainta. Asenna ensin Ollama, lataa malli ja määritä sitten OpenCode:

# Asenna Ollama (jos ei jo asennettu)
curl -fsSL https://ollama.com/install.sh | sh

# Lataa koodausmalli
ollama pull qwen2.5-coder:32b

# OpenCode tunnistaa Ollama-palvelun automaattisesti, kun se ajetaan osoitteessa localhost:11434

Ollama-mallia varten ei tarvita API-avainta. OpenCode tunnistaa sen automaattisesti, kun se on käynnissä paikallisesti.

Anthropic (Claude -- Rajoitettu pääsy)

Anthropic on rajoittanut Claude-pääsyä kolmannen osapuolen työkaluissa, mukaan lukien OpenCode. Jos sinulla on API-avain, joka toimii edelleen:

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

Suurin osa käyttäjistä vuonna 2026 käyttää kuitenkin OpenAI- tai Google Gemini -palvelua ensisijaisena tarjoajanaan OpenCode-työkalun kanssa näiden rajoitusten vuoksi.

---

Keskeiset määritykset: config.toml-läpikäynti

OpenCode käyttää TOML-konfigurointitiedostoa tarkempaa hallintaa varten. Konfigurointitiedosto sijaitsee osoitteessa ~/.config/opencode/config.toml (tai projektin juuressa nimellä opencode.json projektikohtaisia asetuksia varten).

Tässä on käytännön esimerkki config.toml-tiedostosta:

# Tarjoajan konfigurointi
[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"

# Poista käytöstä tarjoajat, joita et käytä
disabled_providers = ["anthropic"]

Tärkeimmät huomiot:

• Muuttujien korvaaminen: Käytä muotoa {env:VARIABLE_NAME} viitataksesi ympäristömuuttujiin sen sijaan, että koodaisit avaimet suoraan tiedostoon.
• Mallin valinta: Voit määrittää tarkalleen, mitä mallia käytetään kunkin tarjoajan alla.
• Käytöstä poistetut tarjoajat: Estä OpenCode-ohjelmaa lataamasta tarjoajia, joiden tunnistetietoja sinulla ei ole, välttääksesi käynnistysvaroitukset.
• Base URL -ylitys: Jos käytät välityspalvelinta tai mukautettua päätepistettä, lisää baseURL = "https://your-proxy.com/v1" tarjoaja-osion alle.

Projektitason konfigurointia varten luo opencode.json projektisi juureen:

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

Tämä ohittaa globaalit asetukset kyseisessä projektissa.

---

Varmista asennus

Käy läpi tämä muistilista varmistaaksesi, että kaikki toimii oikein.

1. Tarkista versio

opencode --version

Sinun pitäisi nähdä versionumero. Maaliskuussa 2026 uusin vakaa versio on 0.x-alueella.

2. Käynnistä TUI

cd any-project-directory
opencode

Sinun pitäisi nähdä OpenCode-terminaaliliittymä, jonka alareunassa on kehote.

3. Testaa yksinkertaista kehotetta

Kirjoita OpenCode TUI-näkymässä yksinkertainen pyyntö:

Explain what this project does based on the file structure.

Jos saat vastauksen AI-mallilta, tarjoajasi määritykset toimivat.

4. Testaa tiedosto-operaatioita

Pyydä OpenCode-ohjelmaa luomaan pieni testitiedosto:

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

Tarkista, että tiedosto luotiin projektihakemistoosi, ja poista se sitten.

---

Yleisimpien ongelmien vianmääritys

"command not found: opencode"

Binääri ei ole PATH-polullasi. Ratkaisut riippuvat asennustavastasi:

• npm: Aja npm list -g opencode-ai varmistaaksesi asennuksen. Jos se on asennettu, tarkista, että npm:n globaali bin-hakemisto on PATH-polullasi: npm config get prefix ja lisää /bin kyseiseen polkuun.
• Go: Lisää $(go env GOPATH)/bin PATH-polullesi.
• Curl-skripti: Aja asennusskripti uudelleen tai siirrä binääri manuaalisesti polkuun /usr/local/bin/.

Käyttöoikeusvirheet npm-asennuksen aikana

Älä käytä komentoa sudo npm install -g. Korjaa sen sijaan npm:n oletushakemisto:

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-ohjelman npm-paketti vaatii Node.js 18+. Tarkista versiosi:

node --version

Jos käytössäsi on vanhempi versio, päivitä nvm-työkalulla:

nvm install 18
nvm use 18

Verkkovirheet yrityksen palomuurin takana

Jos npm-asennus jumiutuu tai epäonnistuu verkkorajoitusten vuoksi:

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

Tai lataa binääri suoraan GitHub releases page -sivulta ja sijoita se PATH-polullesi manuaalisesti.

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

Varmista, että API-avaimen ympäristömuuttuja on viety samassa shell-istunnossa:

echo $OPENAI_API_KEY

Jos se ei tulosta mitään, aseta se uudelleen:

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

Pysyvyyttä varten lisää export-rivi tiedostoosi ~/.zshrc tai ~/.bashrc ja aja source ~/.zshrc.

TUI-renderöintiongelmat (sotkuinen teksti, puuttuvat reunat)

Vaihda nykyaikaiseen terminaaliemulaattoriin, joka tukee true color -värejä. Suositellut vaihtoehdot: iTerm2 (macOS), Alacritty (monialustainen), WezTerm (monialustainen) tai Windows Terminal (Windows).

Go-asennus: "go: command not found"

Go ei ole asennettuna tai se ei ole PATH-polullasi. Asenna Go osoitteesta go.dev/dl ja varmista, että se on PATH-polullasi:

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

---

OpenCode-päivitys

Pidä OpenCode ajan tasalla saadaksesi uusimman mallituen ja virhekorjaukset.

npm:

npm update -g opencode-ai

Homebrew:

brew upgrade opencode

Curl-skripti: Aja asennuskomento uudelleen:

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

Go-asennus: Aja uudelleen @latest-tunnisteella:

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

---

Seuraavat vaiheet

Nyt kun OpenCode on asennettu ja konfiguroitu, olet valmis aloittamaan sen käytön päivittäisessä työnkulussasi.

• Opi komennot: Tutustu oppaaseemme OpenCode Tutorial 2026 nähdäksesi täyden läpikäynnin komennoista, työnkuluista ja edistyneistä ominaisuuksista.
• Määritä GitHub-integraatio: Asenna OpenCode GitHub App käyttääksesi AI-pohjaista koodinkatselmointia ja vastaamiseen issue-tiketteihin suoraan repoissasi.
• Kokeile /init-komentoa: Aja /init projektissasi luodaksesi agents.md-tiedoston, joka antaa OpenCode-ohjelmalle syvän kontekstin koodistosi arkkitehtuurista.
• Kokeile useita tarjoajia: Määritä kaksi tai kolme tarjoajaa ja vaihda niiden välillä löytääksesi, mikä malli toimii parhaiten koodaustehtävissäsi.

OpenCode on yksi nopeimmin kasvavista avoimen lähdekoodin AI-työkaluista vuonna 2026, koska se kohtaa kehittäjät siellä, missä he jo työskentelevät: terminaalissa. Koska asennus kestää alle 5 minuuttia ja konfigurointi vaatii vain yhden API-avaimen, ei ole mitään syytä olla kokeilematta sitä tänään.