OpenCode: namestitev, modeli in prvi zagon

OpenCode je odprtokodni agent za kodiranje z umetno inteligenco v terminalu: samo orodje je brezplačno (licenca MIT), z njim pa lahko povežete kateri koli model — od Claudea in GPT do lokalnega modela prek Ollame. Repozitorij projekta je na GitHubu že presegel dvesto tisoč zvezdic. Izraz »brezplačni Claude Code s katerim koli modelom« zveni vabljivo, vendar ga je treba pojasniti: orodje je brezplačno, pogoji uporabe pa so odvisni od izbranega modela.

V nadaljevanju je vse po uradni dokumentaciji: kaj orodje je, kako ga namestiti v sistem macOS, Linux ali Windows, kako povezati model in kaj storiti ob prvem zagonu. Poseben razdelek je namenjen stroškom, saj se »brezplačno« tukaj nanaša samo na orodje: modeli stanejo, kar najpogosteje povzroča zmedo.

Praktične informacije o uporabi Ailooota so v dokumentaciji.

Kaj je OpenCode na kratko?#

Na kratko: OpenCode počne enako kot Claude Code — sprejme nalogo v običajnem jeziku in jo opravi v vašem projektu. Razlikujeta se v dveh pogledih. Koda je v celoti odprta, zato jo lahko preberete in pregledate. Orodje tudi ni vezano na enega samega ponudnika modelov: deluje z več kot 75 ponudniki, od Anthropic in OpenAI do lokalnega modela, ki teče na vaši strojni opremi.

Projekt razvija ekipa Anomaly. Repozitorij je bil ustvarjen 30. aprila 2025, 4. oktobra 2026 pa je imel več kot 211 tisoč zvezdic in 28 tisoč razcepov (preverjeno z zahtevo API-ja GitHub). Programski jezik je TypeScript. Dokumentacija se nenehno posodablja, zato spodnja navodila temeljijo na trenutni različici.

Ne zamenjujte imen: paket npm za trenutno linijo se imenuje opencode-ai, repozitorij je anomalyco/opencode, ukaz v terminalu pa je preprosto opencode. Starejši članki lahko uporabljajo naslov sst/opencode: organizacija je spremenila ime, stara povezava pa zdaj preusmerja na novo.

Posodobljeno 4. oktobra 2026: ekipa je izdala OpenCode 2.0, naslednjo glavno generacijo orodja. Spodnja navodila za namestitev in povezavo modela so še vedno napisana za trenutno linijo 1.x (namesti se z ukazom curl -fsSL https://opencode.ai/install | bash; trenutna različica na dan 30. septembra 2026 je 1.18.34): ta je še aktivno podprta in jo namesti uradna dokumentacija na opencode.ai/docs. Kaj se je v drugi različici natančno spremenilo in kdaj preiti nanjo, je obravnavano v ločenem razdelku spodaj.

V čem se OpenCode razlikuje od Claude Code in Codexa?#

Če že imate naročnino Claude, je smiselno, da Claude Code obdržite kot glavno orodje — o njem imamo podroben vodnik za namestitev. OpenCode je smiseln v treh primerih: če želite delati prek naročnine ChatGPT Plus ali GitHub Copilot, poganjati lokalni model brez stroškov API-ja ali uporabljati en sam vmesnik za več modelov. Tudi za Codex imamo pregled in vodnik za namestitev.

Če še izbirate orodje, začnite s tem pregledom: s čim ljudje programirajo v letu 2026. Če pa že imate nameščen OpenCode in ga morate prek ACP povezati z drugimi agenti v Devin Desktopu, si oglejte vodnik za to nastavitev.

Kaj se je spremenilo v OpenCode 2.0?#

Druga različica se namesti z ukazom curl -fsSL https://opencode.ai/v2/install | bash. Po uradnem vodniku za selitev (opencode.ai/v2/docs/migrate-v1) obe različici uporabljata isti ukaz opencode in privzeto nista več nameščeni druga ob drugi: namestitveni program v2 zamenja binarno datoteko v1, dokumentacija pa pred namestitvijo v2 prek upravitelja paketov izrecno zahteva, da najprej odstranite različico v1. Konfiguracija pa se bere iz istih datotek — ~/.config/opencode/ in <project>/.opencode/ — zato se nastavitve, agenti in strežniki MCP prenesejo brez prepisovanja. Prepisati je treba tri stvari: vtičnike (imajo nov API), integracije z API-jem strežnika (protokol se je spremenil) in nastavitve terminala (zdaj je na voljo ena skupna datoteka cli.json namesto več datotek tui.json).

Dve najopaznejši novi funkciji v v2 sta naslednji. Prva je Console — plačljiva storitev za ekipe s sledenjem uporabi, proračuni in skupnimi pravilniki za vse člane. Druga je, da je ekipa končno objavila ceno naročnine Go: $10 na mesec za Go in $40 na mesec za Go Plus z višjimi omejitvami (stran opencode.ai/go, preverjena 4. oktobra 2026). Prej je dokumentacija omenjala le »cenovno ugodno naročnino«, ne da bi navedla znesek.

Če ste novi uporabnik in želite agenta samo namestiti, sledite spodnjim navodilom; zajemajo trenutno prvo različico, ki jo priporoča tudi sama dokumentacija. O v2 razmislite, če potrebujete nove funkcije vtičnikov ali Console za ekipe — vendar se pripravite na prepis nekaterih starejših vtičnikov za novi API. Če vas bolj zanima odprtokodna namizna aplikacija, ki ne zahteva terminala, si oglejte naš pregled ZCode, še enega podobnega agenta z lastnim vmesnikom.

Kaj potrebujete pred namestitvijo?#

Nekaj več o terminalu, saj je to edino mesto, kjer namestitev morda ne bo potekala po načrtih. OpenCode v terminalu izriše celoten vmesnik s podokni in označevanjem, zato dokumentacija zahteva sodoben emulator. Če je vmesnik po zagonu videti napačen, najprej namestite eno od štirih navedenih možnosti: WezTerm (deluje v vseh sistemih), Alacritty, Ghostty ali Kitty. V sistemu Windows je glavna pot prek WSL; ta ima spodaj svoj razdelek.

Druga stvar je model. OpenCode deluje prek povezanega modela: sam ne obdeluje zahtev. Na voljo so štiri možnosti: naročnina (ChatGPT Plus, GitHub Copilot, GitLab Duo), ključ API-ja katerega koli ponudnika, OpenCode Zen, agregator lastne ekipe, ali lokalni model prek Ollame. Vse štiri možnosti so obravnavane v razdelku o povezovanju modela.

Brez opisa projekta mora agent ugibati ukaze za gradnjo, strukturo datotek in uporabljene konvencije — od tod »halucinacije«. OpenCode za to uporablja datoteko AGENTS.md. Enak pristop velja za Claude Code in katerega koli drugega agenta; spremeni se samo ime datoteke z navodili.

Kako namestiti OpenCode v sistemih macOS in Linux?#

Priporočena pot je uradni namestitveni program:

1. Zaženite namestitveni program

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

   Skript zazna vaš sistem in prenese OpenCode. Če ukaz po namestitvi ni najden, zaprite in znova odprite terminal; pot bo prepoznana v novi seji.

2. Preverite, ali je bila namestitev uspešna

   opencode --version
   

   Ukaz vrne številko različice, kar pomeni, da je namestitev uspela. Odgovor »command not found« vas vrne na prvi korak: začnite novo sejo terminala ali ročno uredite PATH.

Če želite pakete upravljati sami, imate na voljo te možnosti:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Ukaz Homebrew se namenoma začne z anomalyco/tap/: dokumentacija priporoča njihov tap, ker ekipa Homebrew redkeje posodablja formulo za brew install opencode. Enako ime paketa, opencode-ai, deluje tudi z bun, pnpm in yarn (bun install -g opencode-ai, yarn global add opencode-ai). V Arch Linuxu uporabite sudo pacman -S opencode iz stabilnega repozitorija ali paru -S opencode-bin za najnovejšo različico iz AUR.

OpenCode posodobite z ukazom opencode upgrade; ob zagonu sam prenese tudi posodobitve, če je vklopljeno samodejno posodabljanje. Po posodobitvi preverite različico z znanim ukazom opencode --version. Vgrajena je tudi odstranitev:

opencode uninstall

Ukaz natančno pokaže, kaj bo izbrisano, in zahteva potrditev. Če želite, lahko obdržite konfiguracijo in podatke sej: uporabite zastavici --keep-config in --keep-data.

Kako namestiti OpenCode v sistemu Windows?#

Prva možnost, ki jo priporočajo razvijalci, je WSL. Namestite ga z enim ukazom v PowerShellu, ki ga zaženete kot skrbnik:

wsl --install

Po ponovnem zagonu odprite Ubuntu v meniju Start in v njem izvedite znani ukaz:

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

Datoteke na pogonih Windows so v WSL dostopne prek /mnt/ — pogon C: je v /mnt/c/, pogon D: pa v /mnt/d/. Projekt na poti C:\Users\Name\project lahko torej odprete tako:

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

Druga možnost je, da preskočite WSL in uporabite upravitelje paketov za Windows. V PowerShellu:

choco install opencode

scoop install opencode

Tretja možnost sta namizna aplikacija in spletna različica. Aplikacijo namestite kot običajen program, vmesnik pa prikaže v oknu brez terminala. Spletna različica se zažene z ukazom opencode web: OpenCode odpre v brskalniku, dokumentacija pa priporoča tudi zagon iz WSL, da se izognete težavam pri dostopu do datotek. Dokumentacija navaja tudi manj pogoste možnosti — mise, Docker in že pripravljeno binarno datoteko s strani GitHub Releases. Namestitev prek bun v sistemu Windows je še v pripravi; če je bun vaš glavni upravitelj paketov, uporabite možnost npm.

Kako povezati model z OpenCode?#

OpenCode prek AI SDK in Models.dev podpira več kot 75 ponudnikov ter lokalne modele. Večino povežete z ukazom /connect v vmesniku; pri lokalnih modelih v konfiguraciji navedete tudi naslov strežnika. Možnosti se razlikujejo po načinu plačila in zahtevah glede računalnika:

Dokumentacija začetnikom priporoča, naj začnejo z OpenCode Zen. Ekipa je izbrala modele, ki se posebej dobro obnesejo kot agenti, njihove kombinacije s ponudniki pa preizkusila na lastnih nalogah.

Povezovanje poteka tako: vnesite /connect, izberite OpenCode Zen, prijavite se in dodajte način plačila na opencode.ai/auth, pridobite ključ ter ga prilepite. Nato bo /models prikazal seznam priporočenih modelov. Na dan 4. oktobra 2026 je seznam na primer vključeval GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 in Kimi K2.5. Dokumentacija pošteno opozarja, da seznam ni izčrpen in hitro zastara, saj se vsak teden pojavijo novi modeli.

Naročnine povežete z istim ukazom /connect: na seznamu izberite ChatGPT Plus ali GitHub Copilot in se prijavite v svoj račun — dodatna nastavitev ni potrebna.

Če izberete Anthropic, /connect ponudi dve možnosti: ročni vnos ključa API-ja ali izbiro Claude Pro/Max in avtentikacijo prek brskalnika. Anthropic pa prepoveduje vtičnike tretjih oseb za uporabo naročnine Claude Pro/Max, vgrajene vtičnike te vrste pa so iz OpenCode odstranili z različico 1.3.0. Če naletite na starejši članek o »OpenCodeu prek naročnine Claude«, se nanaša na odstranjene vtičnike, ne na uradno pooblastilo. Naročnine ChatGPT Plus, GitHub Copilot, GitLab Duo (označena kot eksperimentalna) in Atomic Chat delujejo brez dodatne nastavitve.

OpenCode ključe, ki jih vnesete prek /connect, shrani v datoteko ~/.local/share/opencode/auth.json. Če ne želite vsakič izbirati modela, nastavite privzeti model v konfiguracijski datoteki opencode.json v korenski mapi projekta:

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

Oblika je provider/model; oba identifikatorja sta prikazana v izpisu ukaza /models.

Kako povezati lokalni model prek Ollame?#

Pri tej možnosti sploh ni stroškov API-ja: model deluje v vašem računalniku. Če na splošno izbirate med brezplačnimi modeli, imamo ločen pregled o tem, kateri se kot agenti obnesejo dovolj dobro in kateri samo na papirju. Za OpenCode namestite Ollamo z uradnega spletnega mesta in prenesite model:

ollama pull qwen3-coder

Uporabna podrobnost iz dokumentacije: Ollama se lahko samodejno konfigurira za OpenCode; na voljo je ločen vodnik za integracijo. Če želite vse nastaviti ročno, v opencode.json dodajte ponudnika z naslovom lokalnega strežnika Ollama:

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

Nato bo vmesnik na seznamu /models prikazal lokalni model. Izberite ga in začnite delati. Praktična opomba iz dokumentacije: če agent preneha klicati orodja (urejati datoteke ali izvajati ukaze), v nastavitvah Ollame povečajte num_ctx — začnite z vrednostjo 16k–32k. Lokalni modeli so pri agentskem delu slabši od modelov v oblaku, majhen kontekst pa to še poslabša. Če lokalna različica ne zadostuje, lahko Qwen povežete iz oblaka s ključem; navodila za pridobitev ključa so v vodniku kako pridobiti ključ API-ja za Qwen Code.

Koliko stane OpenCode in njegova uporaba?#

Vsi tukaj navedeni stroški se nanašajo na model, na voljo pa so štirje scenariji. Pri ključu API-ja ali Zenu plačate glede na dejansko uporabo, znesek pa je odvisen od tega, koliko dela agent. Go je naročniški paket za odprte modele ekipe OpenCode: $10 na mesec za Go in $40 na mesec za Go Plus z višjimi omejitvami (preverjeno na strani opencode.ai/go 4. oktobra 2026). Omejitev je odvisna od modela: Go na primer omogoča približno 110 zahtev na 5 ur (440 na mesec) za Kimi K3 in približno 26.000 zahtev na 5 ur za lažji DeepSeek V4.1 Flash. Za dostop do določenega modela nad omejitvijo dokumentacija navaja ločeno ceno ($15 na mesec za Kimi K3, $60 za Go Plus). Celoten seznam modelov in omejitev si oglejte na strani z naročninami ob povezovanju. Pri ChatGPT Plus ali Copilotu zahteve krije naročnina, ki jo že plačujete; upoštevajte le, da imajo naročnine lastne omejitve intenzivnosti uporabe. Nazadnje, zahteve do lokalnega modela prek Ollame so brezplačne — vendar potrebujete dovolj zmogljiv računalnik, da bo model deloval hitro.

Kaj storiti ob prvem zagonu?#

Prvi zagon izvedite v mapi projekta:

cd path/to/project
opencode

Vmesnik se odpre z vnosnim poljem. Najprej uporabite ukaz /init: agent pregleda pomembne datoteke repozitorija, po potrebi postavi nekaj vprašanj in ustvari datoteko AGENTS.md — vodnik po strukturi projekta, ukazih za gradnjo in teste ter uporabljenih konvencijah. Dokumentacija priporoča, da to datoteko vključite v git; OpenCode jo nato uporablja kot trajno navodilo za projekt. Po namenu je AGENTS.md neposredna ustreznica datoteke CLAUDE.md v ekosistemu OpenCode.

Drugič, uporabite način Plan. S tipko Tab preklapljate med glavnima agentoma: Build ima poln dostop do datotek in ukazov, Plan pa je namenjen analizi in načrtovanju — v načinu Plan je za urejanje datotek in izvajanje ukazov bash privzeto potrebna vaša odobritev. Pri novih nalogah dokumentacija priporoča, da začnete z načrtom: preberite, kaj namerava agent narediti, prilagodite besedilo in šele nato s tipko Tab preklopite nazaj na Build.

Dokumentacija svetuje naslednje:

Bolj ko je naloga natančna in več konteksta podate, manj dodatnega dela bo potrebnega. Datoteke dodate zahtevi z znakom @ — začnite tipkati ime, vmesnik pa jih bo poiskal z nenatančnim iskanjem. Slike lahko povlečete neposredno v terminal, sporočilo, ki se začne z !, pa se izvede kot ukaz lupine; njegov izhod se doda v kontekst agenta. Če ste nalogo napačno zastavili ali je agent naredil kaj narobe, /undo razveljavi spremembe; ukaz lahko uporabite večkrat zapored. Ste si znova premislili? /redo obnovi razveljavljeno. /share ustvari povezavo do pogovora za vašo ekipo; brez tega ukaza pogovor ni nikjer objavljen.

Kaj še zna OpenCode?#

Ukazi po meri. Vsako ponavljajočo se zahtevo lahko spremenite v ukaz: v mapo .opencode/commands/ dodajte datoteko markdown, v njeno glavo vpišite description, agent in model, pod njimi pa napišite predlogo poziva. Nato ukaz pokličite z /. Preverjanje projekta pred objavo, pregled nedavnih napak, priprava migracije — kar koli pogosto zahtevate.

Podagenti. Poleg Build in Plan so na voljo še trije: General za večstopenjske naloge (dostop do vseh orodij razen seznama nalog), Explore za hitro branje kode brez dovoljenja za urejanje ter Scout za raziskovanje zunanjih knjižnic. Pokličete jih tako, da jih v sporočilu omenite z @.

Strežniki MCP. Zunanja orodja povežite prek razdelka mcp v konfiguraciji opencode.json; podprti so tako lokalni kot oddaljeni strežniki. Vsak strežnik MCP doda svoja orodja v kontekst, požrešen strežnik, kot je GitHub, pa lahko zelo hitro porabi kontekst — povežite samo izbrane, tiste, ki jih potrebujete. O konceptu MCP imamo vodnik s pripravljenimi nastavitvami; namenjen je Claude Codeu, vendar je protokol skupen.

Spletna različica in strežnik. opencode web odpre vmesnik v brskalniku. Za dostop z drugega računalnika uporabite opencode serve --hostname 0.0.0.0 --port 4096; ob dostopu prek omrežja vedno nastavite geslo s spremenljivko OPENCODE_SERVER_PASSWORD. Brez gesla strežnik ni zaščiten.

Kaj storiti, če namestitev ne uspe?#

Po namestitvi se prikaže »opencode: command not found«. Terminal še ne pozna nove poti. Najprej zaprite in znova odprite terminal. Če to ne pomaga, poiščite, kam je namestitveni program shranil binarno datoteko, in to mapo dodajte v PATH terminala.

Model se ne odziva ali javlja napako pri avtorizaciji. Preverite, ali je ponudnik povezan: vnesite /connect in se znova avtenticirajte. Ključi so shranjeni v ~/.local/share/opencode/auth.json — če ste namestitev prenesli z drugega računalnika ali izbrisali mape, datoteka morda manjka. Dokumentacija ločeno obravnava napaki ProviderInitError in AI_APICallError: pri prvi znova avtorizirajte ponudnika, pri drugi pa počistite mapo ~/.cache/opencode in znova zaženite program.

Vmesnik je pokvarjen: podokna so razmetana ali se namesto simbolov prikazujejo neberljivi znaki. Najprej preverite terminal. Namestite eno od priporočenih možnosti — WezTerm deluje v vseh treh sistemih — in v njem zaženite OpenCode.

Če nič ne pomaga, preverite dnevnike: v sistemih macOS in Linux so v mapi ~/.local/share/opencode/log/; v sistemu Windows pritisnite Win+R in vnesite %USERPROFILE%\.local\share\opencode\log. Shranjenih je zadnjih deset datotek; podrobno beleženje omogočite z zastavico opencode --log-level DEBUG. Z dnevniki lahko oddate prijavo napake v repozitoriju projekta na GitHubu.

Kaj ljudje še sprašujejo o OpenCode?#

Obiščite Ailoot.