# OpenCode: namestitev, modeli in prvi zagon > Namestitev v sistemih macOS, Linux in Windows, OpenCode 1.x in 2.0, povezovanje ponudnikov in Ollame, konfiguracija, stroški in odpravljanje težav. Source: https://ailoot.ai/blog/sl/opencode-installation-models/ Canonical: https://ailoot.ai/blog/sl/opencode-installation-models/ Language: sl Publisher: Ailoot (https://ailoot.ai/) Translation: guide-190 Revision: sha256-396706e02679212850f9cb787ee3b15b0d566f6b0b8a314f9b88ce37e2c73e62 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](https://ailoot.ai/docs/). ## Kaj je OpenCode na kratko?
Ključne točke OpenCode je odprtokodni agent za kodiranje z umetno inteligenco (licenca MIT) ekipe Anomaly. Deluje v terminalu, na voljo pa je tudi kot namizna aplikacija, razširitev za urejevalnik in spletna različica. Poveste mu, kaj je treba narediti v projektu, agent pa sam bere datoteke, ureja kodo in izvaja ukaze. Samo orodje je brezplačno; povežete svoj model, bodisi v oblaku bodisi lokalni.
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](https://github.com/anomalyco/opencode) (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?
Ključne točke Claude Code deluje samo z modeli Anthropic. Codex je agent OpenAI, vezan na ekosistem ChatGPT. OpenCode je odprto orodje brez vezanosti na ponudnika: je brezplačno, model pa izberete med več kot 75 ponudniki, vključno z naročninama ChatGPT Plus in GitHub Copilot ter lokalnimi modeli.
| Funkcija | OpenCode | Claude Code | Codex | |----|----|----|----| | Koda | Odprta, MIT | Zaprta | Odprta | | Modeli | Več kot 75 ponudnikov in lokalni modeli | Samo Claude | Modeli OpenAI | | Cena orodja | Brezplačno | Naročnina ali žetoni | Naročnina ChatGPT ali žetoni | | Dostop z naročnino | ChatGPT Plus, GitHub Copilot, GitLab Duo | Claude Pro/Max (lastna naročnina) | ChatGPT (lastna naročnina) | | Kje deluje | Terminal, namizje, urejevalnik, brskalnik | Terminal in urejevalnik | Terminal, splet, urejevalnik | | Konfiguracija projekta | AGENTS.md | CLAUDE.md | AGENTS.md | Če že imate naročnino Claude, je smiselno, da Claude Code obdržite kot glavno orodje — o njem imamo [podroben vodnik za namestitev](https://ailoot.ai/blog/sl/install-claude-code/). 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](https://ailoot.ai/blog/sl/openai-codex-install/). Če še izbirate orodje, začnite s tem pregledom: [s čim ljudje programirajo v letu 2026](https://ailoot.ai/blog/sl/ai-coding-tools/). Č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](https://ailoot.ai/blog/sl/codex-claude-agent-opencode-devin-desktop-acp/). ## Kaj se je spremenilo v OpenCode 2.0?
Ključne točke Od 4. oktobra 2026 je OpenCode 2.0 na voljo na opencode.ai, z lastnim namestitvenim programom in novim paketom npm `@opencode/cli`. Prva različica — tista, ki jo namesti ta članek — ni izginila: v dokumentaciji ima ločeno vejo `V1`, je še vedno aktivno podprta in ostaja privzeta možnost. V v2 so tri področja, pri katerih razvijalci namenoma niso ohranili združljivosti s prvo različico: API za vtičnike, protokol strežnika in datoteka z nastavitvami terminala.
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 `/.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](https://ailoot.ai/blog/sl/zcode-claude-code-alternative/), še enega podobnega agenta z lastnim vmesnikom. ## Kaj potrebujete pred namestitvijo?
Ključne točke Potrebujete dve stvari: sodoben terminalski emulator (dokumentacija navaja WezTerm, Alacritty, Ghostty ali Kitty) in dostop do modela — ključ API-ja ponudnika, podprto naročnino ali lokalni model prek Ollame. Model boste potrebovali po namestitvi: povezali ga boste ob prvem zagonu.
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?
Ključne točke En ukaz v terminalu: curl -fsSL \| bash. Dokumentacija ga imenuje najpreprostejši način. Alternative: brew install anomalyco/tap/opencode, npm install -g opencode-ai, v Arch Linuxu pa pacman ali paru.
Priporočena pot je uradni namestitveni program: 1. ### Zaženite namestitveni program ```bash 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 ```bash 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: ```bash brew install anomalyco/tap/opencode ``` ```bash 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: ```bash 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?
Ključne točke Dokumentacija zaradi zmogljivosti in popolne združljivosti priporoča WSL: namestite Windows Subsystem for Linux, nato pa v njem namestite OpenCode z običajnim ukazom za Linux. Brez WSL lahko uporabite Chocolatey (`choco install opencode`), Scoop (`scoop install opencode`), npm ali namizno aplikacijo.
Prva možnost, ki jo priporočajo razvijalci, je WSL. Namestite ga z enim ukazom v PowerShellu, ki ga zaženete kot skrbnik: ```powershell wsl --install ``` Po ponovnem zagonu odprite Ubuntu v meniju Start in v njem izvedite znani ukaz: ```bash 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: ```bash cd /mnt/c/Users/Name/project opencode ``` Druga možnost je, da preskočite WSL in uporabite upravitelje paketov za Windows. V PowerShellu: ```powershell choco install opencode ``` ```powershell 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?
Ključne točke V terminalskem vmesniku vnesite `/connect` in na seznamu izberite ponudnika: OpenCode Zen za začetek brez lastnih ključev, Anthropic ali OpenAI s ključem API-ja, ChatGPT Plus ali GitHub Copilot z naročnino ali Ollama za lokalni model. Ključi se shranijo v datoteko auth.json; določen model izberete z ukazom `/models`.
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: | Možnost | Kaj je to | Strošek | |----|----|----| | OpenCode Zen | Agregator modelov, ki ga je preverila ekipa OpenCode | Plačilo na zahtevo, dobroimetje je treba dopolniti | | OpenCode Go | Naročniški paket za odprte modele ekipe | \$10 na mesec (Go) ali \$40 na mesec (Go Plus z višjimi omejitvami) | | Ključ API-ja | Anthropic, OpenAI, Google, DeepSeek in drugi | Ponudniku plačate glede na uporabo | | Naročnina | ChatGPT Plus, GitHub Copilot, GitLab Duo | Že plačano | | Ollama / LM Studio | Lokalni model na vaši strojni opremi | Brez stroškov API-ja, vendar potrebujete dovolj zmogljiv računalnik | 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: ```json { "$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?
Ključne točke Namestite Ollamo s strani ollama.com in prenesite model z ukazom `ollama pull` — Ollama se lahko samodejno konfigurira za OpenCode. Ročni način je, da v `opencode.json` dodate ponudnika z naslovom lokalnega strežnika . Model izberite z ukazom `/models`. Če agent ne kliče orodij, v Ollami povečajte `num_ctx` na 16k–32k.
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](https://ailoot.ai/blog/sl/free-coding-models/) 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: ```bash 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: ```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" } } } } } ``` 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](https://ailoot.ai/blog/sl/qwen-code-api-key/). ## Koliko stane OpenCode in njegova uporaba?
Ključne točke OpenCode je brezplačen: njegova izvorna koda je objavljena pod licenco MIT. Plačate samo model: glede na dejansko uporabo prek ključa API-ja ali Zena, z naročnino Go, prek naročnine ChatGPT Plus ali Copilot — ali pa nič; zahteve do lokalnega modela prek Ollame so brezplačne.
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?
Ključne točke Odprite mapo projekta, zaženite opencode in uporabite ukaz `/init` — agent bo pregledal projekt in ustvaril datoteko AGENTS.md z njegovim opisom. Pred urejanjem pritisnite Tab, da preklopite v način Plan: predlagal bo rešitev in vam prikazal spremembe v odobritev. Napačna dejanja razveljavite z ukazom `/undo`.
Prvi zagon izvedite v mapi projekta: ```bash 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:

Z njim se pogovarjajte, kot bi se pogovarjali z mlajšim razvijalcem v svoji ekipi.

— Uradna dokumentacija OpenCode, https://opencode.ai/docs/
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?
Ključne točke Ustvarjanje ukazov po meri iz datotek markdown v mapi `.opencode/commands`, podagenti za vzporedne naloge in branje kode, strežniki MCP za zunanja orodja, spletna različica v brskalniku in strežniški način za delo na daljavo.
**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](https://ailoot.ai/blog/sl/mcp-servers-claude-code/); 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?
Ključne točke Skoraj vse težave se skrčijo na tri: ukaza `opencode` ni mogoče najti (zaženite novo sejo terminala ali uredite PATH), model se ne odziva (preverite ključ z ukazom `/connect` in datoteko `auth.json`) ali pa je vmesnik napačno prikazan (uporabite sodoben terminal, kot je WezTerm). Odpravljanje težav začnite z dnevniki v `~/.local/share/opencode/log/`.
**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?
Ključne točke Kratki odgovori na pogosta vprašanja: OpenCode je kot orodje brezplačen, plačate samo model. Claude Pro/Max povežete prek ukaza `/connect`, vtičniki tretjih oseb za to pa so prepovedani. Do njega lahko dostopate s telefona prek spletne različice. OpenCode posodobite z ukazom `opencode upgrade`.
### Pogosta vprašanja Ali je OpenCode brezplačen? Da, njegova izvorna koda je objavljena pod licenco MIT. Model je lahko plačljiv; vse možnosti so opisane zgoraj v razdelku o stroških. Ali lahko povežem naročnino Claude Pro/Max? Da, Anthropic v ukazu `/connect` ponuja uradno možnost Claude Pro/Max z avtentikacijo prek brskalnika. Starejši članki o uporabi naročnine Claude prek vtičnikov so zastareli: Anthropic te vtičnike prepoveduje, iz OpenCodea pa so jih odstranili z različico 1.3.0. Ali je OpenCode na voljo v telefonu? Uporabna možnost je spletna različica: zaženite `opencode serve` v računalniku ali strežniku, nato pa se povežite prek brskalnika v telefonu. Za vsak dostop prek omrežja je obvezno geslo, nastavljeno s spremenljivko `OPENCODE_SERVER_PASSWORD`. V čem je OpenCode boljši od Claude Code? Odvisno je od vaših modelov in naročnin: Claude Code se povezuje z modeli Anthropic, OpenCode pa ponuja več kot 75 ponudnikov, odprtokodno kodo in lokalne modele. Celotno primerjavo najdete v zgornji tabeli. Ali naj takoj namestim OpenCode 2.0? Ni nujno. Dokumentacija privzeto priporoča trenutno prvo različico — to je različica, ki jo v tem vodniku namestite z ukazom curl -fsSL https://opencode.ai/install \| bash. Druga različica je na voljo od 4. oktobra 2026, vendar v njej vtičniki in integracije z API-jem strežnika delujejo drugače, zato bo treba nekaj kode prepisati.
### Viri - [OpenCode, uradna dokumentacija](https://opencode.ai/docs/) - [Ponudniki modelov](https://opencode.ai/docs/providers/) - [Izbira in konfiguracija modelov](https://opencode.ai/docs/models/) - [OpenCode Zen](https://opencode.ai/docs/zen/) - [Agenti in podagenti](https://opencode.ai/docs/agents/) - [Datoteka pravil AGENTS.md](https://opencode.ai/docs/rules/) - [Ukazi po meri](https://opencode.ai/docs/commands/) - [Strežniki MCP](https://opencode.ai/docs/mcp-servers/) - [OpenCode v sistemu Windows prek WSL](https://opencode.ai/docs/windows-wsl) - [Terminalski vmesnik](https://opencode.ai/docs/tui/) - [Spletna različica](https://opencode.ai/docs/web/) - [Odpravljanje težav](https://opencode.ai/docs/troubleshooting/) - [Ukazna vrstica](https://opencode.ai/docs/cli/) - [Repozitorij OpenCode na GitHubu](https://github.com/anomalyco/opencode) - [OpenCode 2.0: prehod z različice 1](https://opencode.ai/v2/docs/migrate-v1/) - [OpenCode Go: paketi in omejitve](https://opencode.ai/go)
[Obiščite Ailoot](https://ailoot.ai/). ## Pogosta vprašanja o ponudnikih API v OpenCode ### Zakaj namestitev OpenCode ne zagotovi delujočega modela? Orodje in dostop do modela sta ločena. V /connect povežite ponudnika ali podprto naročnino oziroma nastavite lokalni model, nato ga izberite v /models in preverite eno omejeno projektno nalogo. ### Kaj preverim pred prehodom iz OpenCode 1.x na 2.0? Preverite združljivost vtičnikov, povezav s strežniškim API in nastavitev terminala. Vodnik jih navaja kot področja selitve; pred zamenjavo izvedljive datoteke preverite nameščeno različico ter ohranite konfiguracijo in seje. ## Ailoot · Podjetje in njegov portfelj projektov Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI. Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah. Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.