# OpenCode: diegimas, modeliai ir pirmasis paleidimas > Diegimas „macOS“, „Linux“ ir „Windows“ sistemose, „OpenCode 1.x“ ir „2.0“, tiekėjų ir „Ollama“ prijungimas, konfigūracija, išlaidos ir trikčių šalinimas. Source: https://ailoot.ai/blog/lt/opencode-installation-models/ Canonical: https://ailoot.ai/blog/lt/opencode-installation-models/ Language: lt Publisher: Ailoot (https://ailoot.ai/) Translation: guide-190 Revision: sha256-2b980311a619634449a92ae7b44fb1f611e94d974d083db871b8d189afbf27bd „OpenCode“ yra atvirojo kodo DI programavimo agentas, skirtas terminalui: pats įrankis yra nemokamas (MIT licencija), o prie jo galite prijungti bet kurį modelį – nuo „Claude“ ir GPT iki vietinio modelio per „Ollama“. Projekto saugykla „GitHub“ jau perkopė du šimtus tūkstančių žvaigždučių. Frazė „nemokamas „Claude Code“ su bet kuriuo modeliu“ skamba patraukliai, tačiau ją reikia patikslinti: įrankis nemokamas, o naudojimo sąlygos priklauso nuo pasirinkto modelio. Toliau pateikiama visa informacija pagal oficialią dokumentaciją: kas tai per įrankis, kaip jį įdiegti „macOS“, „Linux“ ar „Windows“ sistemoje, kaip prijungti modelį ir ką daryti pirmą kartą paleidus. Atskirame skyriuje aptariamos išlaidos, nes čia „nemokamas“ taikoma tik pačiam įrankiui: modeliai kainuoja, ir būtent tai dažniausiai sukelia painiavą. [Praktinės informacijos apie darbą su „Ailoot“ rasite dokumentacijoje](https://ailoot.ai/docs/). ## Kas yra „OpenCode“ paprastais žodžiais?
Pagrindiniai punktai „OpenCode“ yra atvirojo kodo DI programavimo agentas (MIT licencija), sukurtas „Anomaly“ komandos. Jis veikia terminale, taip pat yra kaip darbalaukio programa, redaktoriaus plėtinys ir žiniatinklio versija. Nurodote, ką reikia atlikti projekte, o agentas pats skaito failus, redaguoja kodą ir vykdo komandas. Pats įrankis yra nemokamas; prijungiate savo modelį – debesijos arba vietinį.
Trumpai tariant, „OpenCode“ atlieka tą patį, ką ir „Claude Code“: priima užduotį įprasta kalba ir ją įvykdo jūsų projekte. Jie skiriasi dviem dalykais. Kodas yra visiškai atviras, todėl galite jį skaityti ir tikrinti. Be to, įrankis nėra susietas su vienu modelių tiekėju: jis veikia su daugiau nei 75 tiekėjais – nuo „Anthropic“ ir „OpenAI“ iki vietinio modelio, veikiančio jūsų aparatinėje įrangoje. Projektą kuria „Anomaly“ komanda. Saugykla sukurta 2025 m. balandžio 30 d., o 2026 m. spalio 4 d. joje buvo [daugiau nei 211 tūkst. žvaigždučių ir 28 tūkst. forkų](https://github.com/anomalyco/opencode) (patikrinta „GitHub“ API užklausa). Naudojama programavimo kalba – „TypeScript“. Dokumentacija nuolat atnaujinama, todėl toliau pateiktos instrukcijos parengtos pagal dabartinę versiją. Nepainiokite pavadinimų: dabartinės linijos npm paketas vadinamas `opencode-ai`, saugykla yra `anomalyco/opencode`, o terminalo komanda – tiesiog `opencode`. Senesniuose straipsniuose gali būti nurodytas adresas `sst/opencode`: organizacija pakeitė pavadinimą, o senoji nuoroda dabar nukreipia į naująją. **Atnaujinta 2026 m. spalio 4 d.:** komanda išleido „OpenCode 2.0“ – naujos kartos pagrindinę įrankio versiją. Toliau pateiktos diegimo ir modelio prijungimo instrukcijos vis dar skirtos dabartinei 1.x linijai (ji įdiegiama komanda `curl -fsSL https://opencode.ai/install | bash`; 2026 m. rugsėjo 30 d. naujausia versija buvo 1.18.34): ji aktyviai palaikoma, ir būtent šią versiją įdiegia oficiali dokumentacija svetainėje opencode.ai/docs. Kas tiksliai pasikeitė antrojoje versijoje ir kada verta prie jos pereiti, aptariama atskirame skyriuje toliau. ## Kuo „OpenCode“ skiriasi nuo „Claude Code“ ir „Codex“?
Pagrindiniai punktai „Claude Code“ veikia tik su „Anthropic“ modeliais. „Codex“ yra „OpenAI“ agentas, susietas su „ChatGPT“ ekosistema. „OpenCode“ yra atviras įrankis, nepririštas prie vieno tiekėjo: jis nemokamas, o modelį galite rinktis iš daugiau nei 75 tiekėjų, įskaitant „ChatGPT Plus“ ir „GitHub Copilot“ prenumeratas, taip pat vietinius modelius.
| Funkcija | OpenCode | Claude Code | Codex | |----|----|----|----| | Kodas | Atviras, MIT | Uždaras | Atviras | | Modeliai | Daugiau nei 75 tiekėjai ir vietiniai modeliai | Tik Claude | OpenAI modeliai | | Įrankio kaina | Nemokamas | Prenumerata arba žetonai | ChatGPT prenumerata arba žetonai | | Prieiga su prenumerata | ChatGPT Plus, GitHub Copilot, GitLab Duo | Claude Pro/Max (asmeninė prenumerata) | ChatGPT (asmeninė prenumerata) | | Kur veikia | Terminalas, darbalaukis, redaktorius, naršyklė | Terminalas ir redaktorius | Terminalas, žiniatinklis, redaktorius | | Projekto konfigūracija | AGENTS.md | CLAUDE.md | AGENTS.md | Jei jau turite „Claude“ prenumeratą, prasminga palikti „Claude Code“ pagrindiniu įrankiu – parengėme jam [išsamų diegimo vadovą](https://ailoot.ai/blog/lt/install-claude-code/). „OpenCode“ tinka trimis atvejais: norite dirbti naudodami „ChatGPT Plus“ arba „GitHub Copilot“ prenumeratą, norite paleisti vietinį modelį ir nemokėti už API arba norite vienos sąsajos keliems modeliams. Taip pat turime „Codex“ [apžvalgą ir diegimo vadovą](https://ailoot.ai/blog/lt/openai-codex-install/). Jei dar renkatės įrankį, pradėkite nuo šios apžvalgos: [su kuo žmonės programuoja 2026 m.](https://ailoot.ai/blog/lt/ai-coding-tools/). O jei „OpenCode“ jau įdiegtas ir norite prijungti jį prie kitų agentų „Devin Desktop“ aplinkoje per ACP, žr. mūsų [šios sąrankos vadovą](https://ailoot.ai/blog/lt/codex-claude-agent-opencode-devin-desktop-acp/). ## Kas pasikeitė „OpenCode 2.0“?
Pagrindiniai punktai 2026 m. spalio 4 d. „OpenCode 2.0“ jau pasiekiamas svetainėje opencode.ai, turi atskirą diegimo programą ir naują npm paketą `@opencode/cli`. Pirmoji versija – ta, kurią įdiegti paaiškina šis straipsnis – niekur nedingo: dokumentacijoje jai skirta atskira `V1` šaka, ji aktyviai palaikoma ir lieka numatytąja parinktimi. V2 versijoje yra trys sritys, kuriose kūrėjai sąmoningai neišsaugojo suderinamumo su pirmąja versija: papildinių API, serverio protokolas ir terminalo nustatymų failas.
Antroji versija įdiegiama komanda `curl -fsSL https://opencode.ai/v2/install | bash`. Pagal oficialų migravimo vadovą (`opencode.ai/v2/docs/migrate-v1`) abi versijos naudoja tą pačią `opencode` komandą ir pagal numatytuosius nustatymus nebėra diegiamos greta: v2 diegimo programa pakeičia v1 dvejetainį failą, o prieš diegiant v2 per paketų tvarkyklę dokumentacijoje aiškiai prašoma pirmiausia pašalinti v1 versiją. Tačiau konfigūracija skaitoma iš tų pačių failų – `~/.config/opencode/` ir `/.opencode/` – todėl nustatymai, agentai ir MCP serveriai perkeliami jų neperrašant. Perrašyti reikia tris dalykus: papildinius (jų API naujas), integracijas su serverio API (pasikeitė protokolas) ir terminalo nustatymus (dabar naudojamas vienas bendras `cli.json` failas vietoj kelių `tui.json` failų). Dvi ryškiausios naujos v2 funkcijos yra šios. Pirma, pristatyta „Console“ – mokama paslauga komandoms, leidžianti stebėti naudojimą, nustatyti biudžetus ir taikyti bendras taisykles visiems nariams. Antra, komanda pagaliau paskelbė „Go“ prenumeratos kainą: \$10 per mėnesį už „Go“ ir \$40 per mėnesį už „Go Plus“ su didesniais limitais (puslapis `opencode.ai/go`, patikrinta 2026 m. spalio 4 d.). Anksčiau dokumentacijoje buvo tiesiog rašoma „nebrangi prenumerata“, nenurodant sumos. Jei tik pradedate ir norite įsidiegti agentą, vadovaukitės toliau pateiktomis instrukcijomis; jose aprašoma dabartinė pirmoji versija, kurią rekomenduoja pati dokumentacija. Apsvarstykite v2, jei jums reikia naujų papildinių funkcijų arba komandoms skirtos „Console“, tačiau turėkite omenyje, kad kai kuriuos senesnius papildinius reikės perrašyti naudojant naują API. Jei labiau domina atvirojo kodo darbalaukio programa, kuriai nereikia terminalo, pateikiame [„ZCode“ apžvalgą](https://ailoot.ai/blog/lt/zcode-claude-code-alternative/) – tai dar vienas panašus agentas su atskira sąsaja. ## Ko reikia prieš diegiant?
Pagrindiniai punktai Jums reikės dviejų dalykų: šiuolaikinio terminalo emuliatoriaus (dokumentacijoje minimi „WezTerm“, „Alacritty“, „Ghostty“ arba „Kitty“) ir prieigos prie modelio – tiekėjo API rakto, palaikomos prenumeratos arba vietinio modelio per „Ollama“. Modelio prireiks jau įdiegus įrankį: jį prijungsite pirmą kartą paleidę programą.
Šiek tiek daugiau apie terminalą, nes būtent čia diegimas gali vykti ne taip, kaip tikėtasi. „OpenCode“ terminale pateikia visą sąsają su skydeliais ir paryškinimu, todėl dokumentacijoje prašoma naudoti šiuolaikinį emuliatorių. Jei paleidus sąsaja atrodo netinkamai, pirmiausia įdiekite vieną iš keturių paminėtų parinkčių: „WezTerm“ (veikia visose sistemose), „Alacritty“, „Ghostty“ arba „Kitty“. Pagrindinis kelias „Windows“ sistemoje yra per WSL; jam skirtas atskiras skyrius toliau. Antras dalykas – modelis. „OpenCode“ veikia per jūsų prijungtą modelį: pats jis užklausų neapdoroja. Galimi keturi variantai: prenumerata („ChatGPT Plus“, „GitHub Copilot“, „GitLab Duo“), bet kurio tiekėjo API raktas, pačios komandos agregatorius „OpenCode Zen“ arba vietinis modelis per „Ollama“. Visi keturi variantai aptariami skyriuje apie modelio prijungimą. Neturėdamas projekto aprašo, agentas turi spėlioti kūrimo komandas, failų struktūrą ir taikomas konvencijas – taip atsiranda „haliucinacijos“. „OpenCode“ tam naudoja AGENTS.md failą. Tas pats požiūris tinka „Claude Code“ ir bet kuriam kitam agentui; keičiasi tik instrukcijų failo pavadinimas. ## Kaip įdiegti „OpenCode“ „macOS“ ir „Linux“ sistemose?
Pagrindiniai punktai Viena komanda terminale: curl -fsSL \| bash. Dokumentacijoje šis būdas vadinamas paprasčiausiu. Alternatyvos: brew install anomalyco/tap/opencode, npm install -g opencode-ai, o „Arch Linux“ sistemoje – pacman arba paru.
Rekomenduojamas būdas – oficialus diegimo įrankis: 1. ### Paleiskite diegimo įrankį ```bash curl -fsSL https://opencode.ai/install | bash ``` Skriptas aptinka jūsų sistemą ir atsisiunčia „OpenCode“. Jei įdiegus komanda nerandama, uždarykite ir vėl atidarykite terminalą – kelias bus aptiktas naujoje sesijoje. 2. ### Patikrinkite, ar įrankis įdiegtas tinkamai ```bash opencode --version ``` Komanda grąžina versijos numerį, vadinasi, diegimas pavyko. Pranešimas „command not found“ reiškia, kad reikia grįžti prie pirmo žingsnio: pradėti naują terminalo sesiją arba rankiniu būdu redaguoti PATH. Jei verčiau patys tvarkytumėte paketus, štai galimos parinktys: ```bash brew install anomalyco/tap/opencode ``` ```bash npm install -g opencode-ai ``` „Homebrew“ komanda sąmoningai prasideda `anomalyco/tap/`: dokumentacijoje rekomenduojamas jų pačių tap, nes „Homebrew“ komanda formulę, naudojamą su `brew install opencode`, atnaujina rečiau. Tą patį paketo pavadinimą `opencode-ai` taip pat galima naudoti su bun, pnpm ir yarn (`bun install -g opencode-ai`, `yarn global add opencode-ai`). „Arch Linux“ sistemoje naudokite `sudo pacman -S opencode` iš stabilios saugyklos arba `paru -S opencode-bin`, kad gautumėte naujausią AUR versiją. Atnaujinkite „OpenCode“ komanda `opencode upgrade`; jei įjungtas automatinis naujinimas, paleista programa naujinimus atsisiunčia ir pati. Atnaujinę patikrinkite versiją įprasta komanda `opencode --version`. Programoje taip pat yra pašalinimo funkcija: ```bash opencode uninstall ``` Komanda tiksliai parodo, kas bus ištrinta, ir paprašo patvirtinimo. Jei norite, konfigūraciją ir sesijos duomenis galite pasilikti: naudokite vėliavėles `--keep-config` ir `--keep-data`. ## Kaip įdiegti „OpenCode“ „Windows“ sistemoje?
Pagrindiniai punktai Dokumentacijoje dėl našumo ir visiško suderinamumo rekomenduojama naudoti WSL: įdiekite „Windows Subsystem for Linux“, tada jame įdiekite „OpenCode“ įprasta „Linux“ komanda. Be WSL galite naudoti „Chocolatey“ (`choco install opencode`), „Scoop“ (`scoop install opencode`), npm arba darbalaukio programą.
Pirmasis pačių kūrėjų rekomenduojamas variantas – WSL. Įdiekite jį viena komanda administratoriaus teisėmis paleistoje „PowerShell“ aplinkoje: ```powershell wsl --install ``` Paleidę kompiuterį iš naujo, meniu „Pradžia“ atidarykite „Ubuntu“ ir jame vykdykite įprastą komandą: ```bash curl -fsSL https://opencode.ai/install | bash ``` „Windows“ diskų failai WSL aplinkoje pasiekiami per `/mnt/`: C: diskas yra `/mnt/c/`, o D: diskas – `/mnt/d/`. Taigi projektą iš `C:\Users\Name\project` galima atidaryti taip: ```bash cd /mnt/c/Users/Name/project opencode ``` Antras variantas – atsisakyti WSL ir naudoti „Windows“ paketų tvarkykles. „PowerShell“ aplinkoje: ```powershell choco install opencode ``` ```powershell scoop install opencode ``` Trečias variantas – darbalaukio programa ir žiniatinklio versija. Programa įdiegiama kaip įprasta programa ir atveria sąsają lange, be terminalo. Žiniatinklio versija paleidžiama komanda `opencode web`: ji atveria „OpenCode“ naršyklėje, o dokumentacijoje taip pat rekomenduojama ją paleisti iš WSL, kad nekiltų failų pasiekiamumo problemų. Dokumentacijoje išvardytos ir retesnės parinktys – mise, Docker ir paruoštas dvejetainis failas iš „GitHub“ leidimų puslapio. Diegimas per bun „Windows“ sistemoje dar kuriamas; jei bun yra jūsų pagrindinė paketų tvarkyklė, rinkitės npm variantą. ## Kaip prijungti modelį prie „OpenCode“?
Pagrindiniai punktai Terminalo sąsajoje įveskite `/connect` ir iš sąrašo pasirinkite tiekėją: „OpenCode Zen“, jei norite pradėti be savo raktų; „Anthropic“ arba „OpenAI“ su API raktu; „ChatGPT Plus“ arba „GitHub Copilot“ su prenumerata arba „Ollama“ vietiniam modeliui. Raktai išsaugomi faile auth.json; konkretų modelį pasirinkite komanda `/models`.
„OpenCode“ palaiko daugiau nei 75 tiekėjus per AI SDK ir Models.dev, taip pat vietinius modelius. Dauguma prijungiami sąsajoje naudojant komandą `/connect`; vietinių modelių atveju konfigūracijoje taip pat nurodoma serverio adreso reikšmė. Parinktys skiriasi mokėjimo būdu ir kompiuterio reikalavimais: | Parinktis | Kas tai | Kaina | |----|----|----| | OpenCode Zen | „OpenCode“ komandos patikrintas modelių agregatorius | Mokestis už užklausą, sąskaitos papildymas | | OpenCode Go | Komandos siūlomas atvirųjų modelių prenumeratos planas | \$10 per mėnesį („Go“) arba \$40 per mėnesį („Go Plus“, didesni limitai) | | API raktas | „Anthropic“, „OpenAI“, „Google“, „DeepSeek“ ir kiti | Mokate tiekėjui už naudojimą | | Prenumerata | „ChatGPT Plus“, „GitHub Copilot“, „GitLab Duo“ | Jau sumokėta | | Ollama / LM Studio | Vietinis modelis jūsų aparatinėje įrangoje | Jokių API mokesčių, bet reikia pakankamai gero kompiuterio | Dokumentacijoje pradedantiesiems rekomenduojama pradėti nuo „OpenCode Zen“. Komanda atrinko modelius, kurie gerai veikia būtent kaip agentai, ir išbandė jų derinius su tiekėjais atlikdama savo užduotis. Prijungimas vyksta taip: įveskite `/connect`, pasirinkite „OpenCode Zen“, prisijunkite ir pridėkite mokėjimo būdą svetainėje opencode.ai/auth, gaukite raktą ir įklijuokite jį. Tada `/models` parodys rekomenduojamų modelių sąrašą. 2026 m. spalio 4 d. jame buvo, pavyzdžiui, GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 ir Kimi K2.5. Dokumentacijoje atvirai įspėjama, kad sąrašas nėra išsamus ir greitai pasensta, nes nauji modeliai pasirodo kas savaitę. Prenumeratos prijungiamos ta pačia komanda `/connect`: sąraše pasirinkite „ChatGPT Plus“ arba „GitHub Copilot“ ir prisijunkite prie savo paskyros – papildomos sąrankos nereikia. Pasirinkus „Anthropic“, `/connect` siūlo dvi galimybes: rankiniu būdu įvesti API raktą arba pasirinkti „Claude Pro/Max“ ir autentifikuotis per naršyklę. Tačiau „Anthropic“ draudžia naudoti trečiųjų šalių papildinius su „Claude Pro/Max“ prenumerata, o tokio tipo integruoti papildiniai iš „OpenCode“ pašalinti nuo 1.3.0 versijos. Jei aptikote senesnį straipsnį apie „OpenCode per „Claude“ prenumeratą“, jame kalbama apie pašalintus papildinius, o ne oficialų leidimą. „ChatGPT Plus“, „GitHub Copilot“, „GitLab Duo“ (pažymėta kaip eksperimentinė) ir „Atomic Chat“ prenumeratos veikia be papildomos sąrankos. „OpenCode“ raktus, įvestus per `/connect`, saugo faile `~/.local/share/opencode/auth.json`. Jei nenorite kaskart rinktis modelio, numatytąjį modelį nustatykite projekto šaknyje esančiame konfigūracijos faile `opencode.json`: ```json { "$schema": "https://opencode.ai/config.json", "model": "anthropic/claude-sonnet-4-5" } ``` Formatas yra `provider/model`; abu identifikatoriai rodomi `/models` išvestyje. ## Kaip prijungti vietinį modelį per „Ollama“?
Pagrindiniai punktai Įdiekite „Ollama“ iš svetainės ollama.com ir atsisiųskite modelį komanda `ollama pull` – „Ollama“ gali automatiškai susikonfigūruoti darbui su „OpenCode“. Rankiniu būdu konfigūracijos faile `opencode.json` pridėkite tiekėją ir vietinio serverio adresą . Modelį pasirinkite komanda `/models`. Jei agentas nekviečia įrankių, „Ollama“ padidinkite `num_ctx` iki 16k–32k.
Ši parinktis reiškia, kad API mokesčių nebus: modelis veikia jūsų kompiuteryje. Jei apskritai renkatės iš nemokamų modelių, turime [atskirą apžvalgą](https://ailoot.ai/blog/lt/free-coding-models/), kurioje aptariama, kurie iš jų gana gerai veikia kaip agentai, o kurie – tik teoriškai. Norėdami naudoti „OpenCode“, įdiekite „Ollama“ iš oficialios svetainės ir atsisiųskite modelį: ```bash ollama pull qwen3-coder ``` Naudinga dokumentacijoje nurodyta detalė: „Ollama“ gali automatiškai susikonfigūruoti darbui su „OpenCode“; tam skirtas atskiras integravimo vadovas. Jei norite viską nustatyti rankiniu būdu, į `opencode.json` įtraukite tiekėją ir vietinio „Ollama“ serverio adresą: ```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" } } } } } ``` Tada sąsajos `/models` sąraše matysite vietinį modelį. Pasirinkite jį ir pradėkite dirbti. Praktinė dokumentacijos pastaba: jei agentas nustoja kviesti įrankius (redaguoti failus ar vykdyti komandas), „Ollama“ nustatymuose padidinkite `num_ctx` – pradėkite nuo 16k–32k reikšmių. Vietiniai modeliai agentų užduotis atlieka prasčiau nei debesijos modeliai, o mažas kontekstas šią problemą dar sustiprina. Jei vietinio modelio nepakanka, galite prijungti debesijos „Qwen“ naudodami raktą; kur jį gauti, paaiškinta vadove [kaip gauti „Qwen Code“ API raktą](https://ailoot.ai/blog/lt/qwen-code-api-key/). ## Kiek kainuoja „OpenCode“ ir jo naudojimas?
Pagrindiniai punktai Pats „OpenCode“ yra nemokamas: jo išeities kodas skelbiamas pagal MIT licenciją. Mokate tik už modelį: pagal faktinį naudojimą per API raktą arba „Zen“, naudodami „Go“ prenumeratą, per turimą „ChatGPT Plus“ arba „Copilot“ prenumeratą, arba visai nemokate – užklausos vietiniam modeliui per „Ollama“ nieko nekainuoja.
Visos čia aptariamos išlaidos susijusios su modeliu; galimi keturi scenarijai. Naudodami API raktą arba „Zen“, mokate už faktinį naudojimą, o suma priklauso nuo agento darbo apimties. „Go“ yra „OpenCode“ komandos siūloma atvirųjų modelių prenumerata: \$10 per mėnesį už „Go“ ir \$40 per mėnesį už „Go Plus“ su didesniais limitais (patikrinta puslapyje `opencode.ai/go` 2026 m. spalio 4 d.). Limitas priklauso nuo modelio: pavyzdžiui, „Go“ leidžia pateikti apie 110 užklausų per 5 valandas („Kimi K3“ – 440 per mėnesį) ir apie 26,000 užklausų per 5 valandas naudojant lengvesnį „DeepSeek V4.1 Flash“. Už prieigą prie konkretaus modelio viršijus limitą dokumentacijoje nurodyta atskira kaina (\$15 per mėnesį už „Kimi K3“, \$60 už „Go Plus“). Visą modelių ir limitų sąrašą rasite prenumeratos puslapyje prisijungdami. Naudojant „ChatGPT Plus“ arba „Copilot“, užklausas padengia jau mokama prenumerata; tik nepamirškite, kad prenumeratoms taikomi atskiri intensyvaus naudojimo limitai. Galiausiai, užklausos vietiniam modeliui per „Ollama“ nieko nekainuoja, tačiau norint jį greitai paleisti reikia pakankamai galingo kompiuterio. ## Ką daryti pirmą kartą paleidus?
Pagrindiniai punktai Pereikite į projekto aplanką, paleiskite opencode ir naudokite komandą `/init` – agentas patikrins projektą ir sukurs jį aprašantį AGENTS.md failą. Prieš atlikdami pakeitimus paspauskite Tab, kad įjungtumėte Plan režimą: agentas pasiūlys sprendimą ir parodys pakeitimus, kuriuos galėsite patvirtinti. Klaidingus veiksmus atšaukite komanda `/undo`.
Pirmasis paleidimas – projekto aplanke: ```bash cd path/to/project opencode ``` Atsidaro sąsaja su įvesties lauku. Pirmiausia naudokite komandą `/init`: agentas peržiūri svarbius saugyklos failus, prireikus užduoda kelis klausimus ir sukuria AGENTS.md failą – vadovą, kuriame aprašyta projekto struktūra, kūrimo ir testavimo komandos bei taikomos konvencijos. Dokumentacijoje rekomenduojama šį failą įtraukti į git; tada „OpenCode“ naudoja jį kaip nuolatinę projekto instrukciją. Pagal paskirtį AGENTS.md yra tiesioginis CLAUDE.md atitikmuo „OpenCode“ ekosistemoje. Antra, naudokite Plan režimą. Klavišas Tab perjungia du pagrindinius agentus: Build turi visą prieigą prie failų ir komandų, o Plan skirtas analizei ir planavimui – pagal numatytuosius nustatymus Plan režimu failams redaguoti ir bash komandoms vykdyti reikia jūsų patvirtinimo. Atliekant naujas užduotis dokumentacijoje rekomenduojama pradėti nuo plano: perskaitykite, ką agentas ketina daryti, pakoreguokite užduoties formuluotę ir tik tada Tab klavišu grįžkite į Build režimą. Dokumentacijoje pateikiamas toks patarimas:

Padeda kalbėti su juo taip, kaip kalbėtumėte su jaunesniuoju savo komandos programuotoju.

— Oficiali „OpenCode“ dokumentacija, https://opencode.ai/docs/
Kuo konkretesnė užduotis ir kuo daugiau konteksto pateiksite, tuo mažiau reikės perdaryti. Pridėkite failų prie užklausos naudodami `@` – pradėkite rašyti pavadinimą, o sąsaja juos suras pagal apytikslę atitiktį. Paveikslėlius galite tiesiogiai nutempti į terminalą, o pranešimas, prasidedantis `!`, vykdomas kaip shell komanda; jos išvestis įtraukiama į agento kontekstą. Jei užduotyje suklydote arba agentas atliko ne tą darbą, `/undo` atšaukia pakeitimus; šią komandą galite vykdyti kelis kartus iš eilės. Persigalvojote dar kartą? `/redo` atkuria tai, kas buvo atšaukta. O `/share` sukuria nuorodą į komandos pokalbį; be šios komandos pokalbis niekur nepaskelbiamas. ## Ką dar gali „OpenCode“?
Pagrindiniai punktai Pasirinktinės komandos iš markdown failų aplanke `.opencode/commands`, subagentai lygiagrečioms užduotims ir kodui skaityti, MCP serveriai išoriniams įrankiams, žiniatinklio versija naršyklėje ir serverio režimas nuotoliniam darbui.
**Pasirinktinės komandos.** Bet kurią pasikartojančią užklausą galima paversti komanda: įdėkite markdown failą į `.opencode/commands/`, frontmatter dalyje nustatykite `description`, `agent` ir `model`, o po ja parašykite prompto šabloną. Tada iškvieskite komandą naudodami `/`. Projekto patikros prieš publikavimą, pastarųjų klaidų peržiūra, migracijos generavimas – bet kas, ko reguliariai prašote. **Subagentai.** Be Build ir Plan, yra dar trys: General – kelių veiksmų užduotims (pasiekiami visi įrankiai, išskyrus užduočių sąrašą), Explore – greitam kodo skaitymui be leidimo jį redaguoti, o Scout – išorinėms bibliotekoms tirti. Iškvieskite juos pranešime paminėję su `@`. **MCP serveriai.** Išorinius įrankius prijunkite per `opencode.json` konfigūracijos skiltį `mcp` – palaikomi ir vietiniai, ir nuotoliniai serveriai. Kiekvienas MCP serveris prideda savo įrankius į kontekstą, o daug išteklių naudojantis serveris, pavyzdžiui, „GitHub“, gali jį labai greitai išnaudoti – prijunkite tik tai, ko reikia. Turime [vadovą su paruoštomis sąrankomis](https://ailoot.ai/blog/lt/mcp-servers-claude-code/), kuriame pristatoma MCP sąvoka; jis parašytas apie „Claude Code“, tačiau protokolas bendras. **Žiniatinklio versija ir serveris.** `opencode web` atidaro sąsają naršyklėje. Norėdami pasiekti ją iš kito kompiuterio, naudokite `opencode serve --hostname 0.0.0.0 --port 4096`; jei pasiekiama per tinklą, būtinai nustatykite slaptažodį naudodami kintamąjį `OPENCODE_SERVER_PASSWORD`. Be slaptažodžio serveris neapsaugotas. ## Ką daryti, jei diegimas nepavyksta?
Pagrindiniai punktai Beveik visos problemos susijusios su trimis dalykais: komandos `opencode` nepavyksta rasti (pradėkite naują terminalo sesiją arba redaguokite PATH), modelis neatsako (patikrinkite raktą naudodami `/connect` ir failą `auth.json`) arba sąsaja rodoma netinkamai (naudokite modernų terminalą, pavyzdžiui, „WezTerm“). Trikčių šalinimą pradėkite nuo žurnalų aplanke `~/.local/share/opencode/log/`.
**Įdiegus rodoma „opencode: command not found“.** Terminalas dar nežino naujojo kelio. Pirmiausia tiesiog uždarykite ir vėl atidarykite terminalą. Jei tai nepadeda, raskite, kur diegimo programa įdėjo dvejetainį failą, ir įtraukite tą aplanką į terminalo PATH. **Modelis tyli arba praneša apie autorizacijos klaidą.** Patikrinkite, ar tiekėjas prijungtas: įveskite `/connect` ir autentifikuokitės iš naujo. Raktai saugomi faile `~/.local/share/opencode/auth.json` – jei perkėlėte įrankį iš kito kompiuterio arba išvalėte aplankus, failo gali trūkti. Dokumentacijoje atskirai aptariamos ProviderInitError ir AI_APICallError klaidos: pirmosios atveju iš naujo autorizuokite tiekėją, o antrosios – išvalykite aplanką `~/.cache/opencode` ir paleiskite programą iš naujo. **Sąsaja neveikia tinkamai: skydeliai išsibarstę arba vietoj simbolių rodomi neįskaitomi ženklai.** Pirmiausia patikrinkite terminalą. Įdiekite vieną iš rekomenduojamų variantų – „WezTerm“ veikia visose trijose sistemose – ir paleiskite „OpenCode“ jame. Jei niekas nepadeda, peržiūrėkite žurnalus: „macOS“ ir „Linux“ sistemose jie saugomi aplanke `~/.local/share/opencode/log/`; „Windows“ sistemoje paspauskite Win+R ir įveskite `%USERPROFILE%\.local\share\opencode\log`. Išsaugoma dešimt naujausių failų; išsamų registravimą įjunkite vėliavėle `opencode --log-level DEBUG`. Turėdami šiuos žurnalus galite pateikti klaidos ataskaitą projekto „GitHub“ saugykloje. ## Ko dar žmonės klausia apie „OpenCode“?
Pagrindiniai punktai Trumpi atsakymai į dažniausiai užduodamus klausimus: pats „OpenCode“ įrankis nemokamas; mokate tik už modelį. „Claude Pro/Max“ prijungiamas per `/connect`, o trečiųjų šalių papildiniai tam draudžiami. Prie įrankio galima prisijungti telefonu per žiniatinklio versiją. „OpenCode“ atnaujinamas komanda `opencode upgrade`.
### Dažnai užduodami klausimai Ar „OpenCode“ nemokamas? Taip, jo išeities kodas skelbiamas pagal MIT licenciją. Už modelį gali tekti mokėti; visos parinktys aptartos anksčiau esančiame išlaidų skyriuje. Ar galiu prijungti „Claude Pro/Max“ prenumeratą? Taip, „Anthropic“ oficialiai siūlo „Claude Pro/Max“ parinktį komandoje `/connect`, autentifikuojantis per naršyklę. Senesni straipsniai apie „Claude“ prenumeratos naudojimą per papildinius yra pasenę: „Anthropic“ šiuos papildinius draudžia, o „OpenCode“ jie pašalinti nuo 1.3.0 versijos. Ar „OpenCode“ galima naudoti telefone? Veikiantis variantas yra žiniatinklio versija: kompiuteryje arba serveryje paleiskite `opencode serve`, tada prisijunkite iš telefono naršyklės. Bet kokiai tinklo prieigai būtinas slaptažodis `OPENCODE_SERVER_PASSWORD`. Kuo „OpenCode“ geresnis už „Claude Code“? Tai priklauso nuo jūsų modelių ir prenumeratų: „Claude Code“ integruojamas su „Anthropic“ modeliais, o „OpenCode“ siūlo daugiau nei 75 tiekėjus, atvirojo kodo kodą ir vietinius modelius. Visą palyginimą rasite aukščiau pateiktoje lentelėje. Ar turėčiau iškart įdiegti „OpenCode 2.0“? Nebūtinai. Dokumentacijoje pagal numatytuosius nustatymus rekomenduojama dabartinė pirmoji versija – ta, kuri šiame vadove įdiegiama komanda curl -fsSL https://opencode.ai/install \| bash. Antroji versija prieinama nuo 2026 m. spalio 4 d., tačiau joje papildiniai ir integracijos su serverio API veikia kitaip, todėl dalį kodo reikės perrašyti.
### Šaltiniai - [OpenCode, oficiali dokumentacija](https://opencode.ai/docs/) - [Modelių tiekėjai](https://opencode.ai/docs/providers/) - [Modelių pasirinkimas ir konfigūravimas](https://opencode.ai/docs/models/) - [OpenCode Zen](https://opencode.ai/docs/zen/) - [Agentai ir subagentai](https://opencode.ai/docs/agents/) - [AGENTS.md taisyklių failas](https://opencode.ai/docs/rules/) - [Pasirinktinės komandos](https://opencode.ai/docs/commands/) - [MCP serveriai](https://opencode.ai/docs/mcp-servers/) - [OpenCode „Windows“ sistemoje per WSL](https://opencode.ai/docs/windows-wsl) - [Terminalo sąsaja](https://opencode.ai/docs/tui/) - [Žiniatinklio versija](https://opencode.ai/docs/web/) - [Trikčių šalinimas](https://opencode.ai/docs/troubleshooting/) - [Komandinė eilutė](https://opencode.ai/docs/cli/) - [OpenCode saugykla „GitHub“](https://github.com/anomalyco/opencode) - [OpenCode 2.0: migravimas iš 1 versijos](https://opencode.ai/v2/docs/migrate-v1/) - [OpenCode Go: planai ir limitai](https://opencode.ai/go)
[Atidarykite „Ailoot“](https://ailoot.ai/). ## Klausimai ir atsakymai ### Kodėl įdiegus OpenCode dar nėra veikiančio modelio? Įrankis ir modelio prieiga atskiri. Per /connect prijunkite teikėją ar palaikomą prenumeratą arba nustatykite vietinį modelį, tada pasirinkite jį per /models ir patikrinkite vieną apribotą projekto užduotį. ### Ką patikrinti prieš pereinant iš OpenCode 1.x į2.0? Patikrinkite papildinių, serverio API integracijų ir terminalo nustatymų suderinamumą. Vadovas juos išskiria kaip migravimo sritis; prieš keisdami vykdomąjį failą patikrinkite versiją ir išsaugokite konfigūraciją bei sesijas. ## Ailoot · Įmonė ir jos projektų portfelis Ailoot remiasi sukaupta veiklos patirtimi, plačia klientų baze, stabiliomis paslaugomis ir nuolatine KPI kontrole. Įmonė ir jos projektų portfelis: milijonai klientų; mėnesio pardavimai siekia milijardus. Ailoot šią veiklos patirtį pritaiko teikdama API prieigą prie DI funkcijų klientų produktuose, agentuose, programose ir automatizavimo sprendimuose.