Blog

OpenCode: o‘rnatish, modellar va birinchi ishga tushirish

Markdown

macOS, Linux va Windows’da o‘rnatish, OpenCode 1.x va 2.0, provayderlar va Ollama’ni ulash, sozlash, xarajatlar va muammolarni bartaraf etish.

Maqolani to‘liq o‘qish

OpenCode — terminal uchun ochiq kodli AI dasturlash agenti: vositaning o‘zi bepul (MIT litsenziyasi), unga istalgan modelni — Claude va GPT’dan tortib Ollama orqali mahalliy modelgacha — ulashingiz mumkin. Loyiha ombori GitHub’da allaqachon ikki yuz ming yulduzdan oshgan. “Istalgan model bilan bepul Claude Code” degan ibora jozibali eshitiladi, ammo aniqlik kiritish kerak: vosita bepul, foydalanish shartlari esa tanlagan modelingizga bog‘liq.

Quyida rasmiy hujjatlarga asoslangan barcha ma’lumotlar keltirilgan: vosita nima, uni macOS, Linux yoki Windows’da qanday o‘rnatish, modelni qanday ulash va birinchi ishga tushirishda nima qilish kerak. Xarajatlar haqida alohida bo‘lim bor, chunki bu yerda “bepul” degani faqat vositaning o‘ziga tegishli: modellar pulli va chalkashliklar ko‘pincha shundan kelib chiqadi.

Ailoot bilan ishlashga oid amaliy ma’lumotlar hujjatlarda berilgan.

Oddiy qilib aytganda, OpenCode nima?

Asosiy xulosalar

OpenCode — Anomaly jamoasi yaratgan ochiq kodli AI dasturlash agenti (MIT litsenziyasi). U terminalda ishlaydi, shuningdek, ish stoli ilovasi, muharrir kengaytmasi va veb-versiya sifatida ham mavjud. Loyihada nima qilish kerakligini aytasiz, agent esa fayllarni o‘qiydi, kodni tahrirlaydi va buyruqlarni mustaqil bajaradi. Vositaning o‘zi bepul; siz bulutli yoki mahalliy modelni ulaysiz.

Qisqacha aytganda, OpenCode Claude Code bilan bir xil ishni bajaradi: topshiriqni oddiy tilda qabul qilib, loyihangizda bajaradi. Ular ikki jihatdan farq qiladi. Kod to‘liq ochiq, shuning uchun uni o‘qish va tekshirish mumkin. Vosita bitta model provayderiga bog‘lanmagan: Anthropic va OpenAI’dan tortib, uskunangizda ishlaydigan mahalliy modelgacha 75 dan ortiq provayder bilan ishlaydi.

Loyihani Anomaly jamoasi ishlab chiqadi. Ombor 2025-yil 30-aprelda yaratilgan va 2026-yil 4-oktabr holatiga ko‘ra, unda 211 mingdan ortiq yulduz va 28 mingta fork bor (GitHub API so‘rovi bilan tekshirilgan). Dasturlash tili — TypeScript. Hujjatlar muntazam yangilanadi, shu sabab quyidagi ko‘rsatmalar joriy versiyaga asoslangan.

Nomlarni adashtirmang: joriy liniyaning npm paketi opencode-ai deb ataladi, ombor nomi anomalyco/opencode, terminal buyrug‘i esa shunchaki opencode. Eski maqolalarda sst/opencode manzilini uchratishingiz mumkin: tashkilot nomini o‘zgartirgan, eski havola esa endi yangisiga yo‘naltiradi.

2026-yil 4-oktabrda yangilangan: jamoa vositaning keyingi yirik avlodi OpenCode 2.0’ni chiqardi. Quyidagi o‘rnatish va model ulash ko‘rsatmalari hali ham joriy 1.x liniyasi uchun yozilgan (curl -fsSL https://opencode.ai/install | bash buyrug‘i bilan o‘rnatiladi; 2026-yil 30-sentabr holatidagi joriy versiya — 1.18.34): bu versiya faol qo‘llab-quvvatlanadi va opencode.ai/docs saytidagi rasmiy hujjatlar aynan uni o‘rnatadi. Ikkinchi versiyada aynan nimalar o‘zgargani va qachon unga o‘tish kerakligi quyida alohida bo‘limda yoritiladi.

OpenCode Claude Code va Codex’dan nimasi bilan farq qiladi?

Asosiy xulosalar

Claude Code faqat Anthropic modellari bilan ishlaydi. Codex — ChatGPT ekotizimiga bog‘langan OpenAI agenti. OpenCode — provayderga bog‘lanmagan ochiq vosita: u bepul, siz ChatGPT Plus va GitHub Copilot obunalari, shuningdek mahalliy modellarni ham o‘z ichiga olgan 75 dan ortiq provayder orasidan model tanlaysiz.

XususiyatOpenCodeClaude CodeCodex
KodOchiq, MITYopiqOchiq
Modellar75+ provayder va mahalliy modellarFaqat ClaudeOpenAI modellari
Vosita narxiBepulObuna yoki tokenlarChatGPT obunasi yoki tokenlar
Obuna orqali kirishChatGPT Plus, GitHub Copilot, GitLab DuoClaude Pro/Max (o‘z obunangiz)ChatGPT (o‘z obunangiz)
Qayerda ishlaydiTerminal, ish stoli, muharrir, brauzerTerminal va muharrirTerminal, veb, muharrir
Loyiha sozlamasiAGENTS.mdCLAUDE.mdAGENTS.md

Agar sizda Claude obunasi bo‘lsa, Claude Code’ni asosiy vositangiz sifatida ishlatishda davom etganingiz ma’qul — u haqida batafsil o‘rnatish qo‘llanmamiz bor. OpenCode uch holatda foydali: ChatGPT Plus yoki GitHub Copilot obunasi orqali ishlamoqchi bo‘lsangiz, API to‘lovlarisiz mahalliy modelni ishga tushirmoqchi bo‘lsangiz yoki bir nechta model uchun yagona interfeys istasangiz. Codex haqida ham sharh va o‘rnatish qo‘llanmamiz bor.

Agar vosita tanlayotgan bo‘lsangiz, mana bu umumiy sharhdan boshlang: 2026-yilda dasturchilar nimalardan foydalanadi. OpenCode allaqachon o‘rnatilgan bo‘lsa va uni ACP orqali Devin Desktop’dagi boshqa agentlar bilan ulash kerak bo‘lsa, shu sozlama bo‘yicha qo‘llanmamizni ko‘ring.

OpenCode 2.0’da nimalar o‘zgardi?

Asosiy xulosalar

2026-yil 4-oktabr holatiga ko‘ra, OpenCode 2.0 opencode.ai saytida o‘z o‘rnatuvchisi va yangi @opencode/cli npm paketi bilan mavjud. Birinchi versiya — ushbu maqola o‘rnatadigan versiya — yo‘qolmagan: hujjatlarda alohida V1 tarmog‘i bor, u faol qo‘llab-quvvatlanadi va standart tanlov bo‘lib qolmoqda. v2’da ishlab chiquvchilar birinchi versiya bilan moslikni ataylab saqlamagan uchta yo‘nalish bor: plagin API’si, server protokoli va terminal sozlamalari fayli.

Ikkinchi versiya curl -fsSL https://opencode.ai/v2/install | bash buyrug‘i bilan o‘rnatiladi. Rasmiy migratsiya qo‘llanmasiga (opencode.ai/v2/docs/migrate-v1) ko‘ra, ikkala versiyada ham opencode buyrug‘i ishlatiladi va ular endi standart holatda yonma-yon o‘rnatilmaydi: v2 o‘rnatuvchisi v1 ikkilik faylini almashtiradi, paket menejeri orqali v2’ni o‘rnatishdan oldin esa hujjatlar v1 versiyasini avval olib tashlashni aniq so‘raydi. Biroq sozlamalar bir xil fayllardan — ~/.config/opencode/ va <project>/.opencode/ — o‘qiladi, shu sabab sozlamalar, agentlar va MCP serverlarini qayta yozmasdan ko‘chirish mumkin. Uch narsani qayta yozish kerak: plaginlar (ularning API’si yangilangan), server API bilan integratsiyalar (protokol o‘zgargan) va terminal sozlamalari (bir nechta tui.json fayli o‘rniga endi yagona umumiy cli.json fayli ishlatiladi).

v2’dagi ikkita eng e’tiborga molik yangi imkoniyat shular. Birinchidan, foydalanishni kuzatish, budjetlar va barcha a’zolar uchun umumiy siyosatlarga ega jamoaviy pulli xizmat — Console taqdim etildi. Ikkinchidan, jamoa nihoyat Go obunasi narxini e’lon qildi: Go uchun oyiga $10, yuqoriroq limitli Go Plus uchun esa oyiga $40 (opencode.ai/go sahifasida 2026-yil 4-oktabrda tekshirilgan). Avval hujjatlarda raqamsiz, shunchaki “arzon obuna” deyilgan edi.

Agar yangi boshlayotgan bo‘lsangiz va agentni o‘rnatmoqchi bo‘lsangiz, quyidagi ko‘rsatmalarga amal qiling; ular hujjatlarning o‘zi tavsiya qilayotgan joriy birinchi versiyani qamrab oladi. Yangi plagin imkoniyatlari yoki jamoaviy Console kerak bo‘lsa, v2’ni ko‘rib chiqing, ammo eski plaginlarning ayrimlarini yangi API uchun qayta yozishga tayyor bo‘ling. Terminal talab qilmaydigan ochiq kodli ish stoli ilovasi sizni ko‘proq qiziqtirsa, o‘z interfeysiga ega yana bir o‘xshash agent — ZCode sharhimizni ko‘ring.

O‘rnatishdan oldin nimalar kerak?

Asosiy xulosalar

Sizga ikkita narsa kerak: zamonaviy terminal emulyatori (hujjatlarda WezTerm, Alacritty, Ghostty yoki Kitty tavsiya qilingan) va modeldan foydalanish imkoniyati — provayder API kaliti, qo‘llab-quvvatlanadigan obuna yoki Ollama orqali mahalliy model. Model o‘rnatishdan keyin kerak bo‘ladi: uni birinchi ishga tushirishda ulaysiz.

Terminal haqida biroz batafsilroq, chunki o‘rnatish kutilganidek kechmasligi mumkin bo‘lgan yagona joy shu. OpenCode terminalda panellar va ajratib ko‘rsatishlarga ega to‘liq interfeysni chizadi, shu sabab hujjatlar zamonaviy emulyatordan foydalanishni so‘raydi. Ishga tushirgandan keyin interfeys noto‘g‘ri ko‘rinsa, avval sanab o‘tilgan to‘rtta variantdan birini o‘rnating: WezTerm (barcha tizimlarda ishlaydi), Alacritty, Ghostty yoki Kitty. Windows’da asosiy yo‘l WSL orqali; bu haqda quyida alohida bo‘lim bor.

Ikkinchi kerakli narsa — model. OpenCode siz ulaydigan model orqali ishlaydi: o‘zi mustaqil so‘rovlarni qayta ishlamaydi. To‘rtta variant bor: obuna (ChatGPT Plus, GitHub Copilot, GitLab Duo), istalgan provayderning API kaliti, jamoaning o‘z agregatori OpenCode Zen yoki Ollama orqali mahalliy model. To‘rtta variantning barchasi model ulash bo‘limida ko‘rib chiqiladi.

Loyiha tavsifi bo‘lmasa, agent yig‘ish buyruqlari, fayllar tuzilishi va qo‘llanadigan qoidalarni taxmin qilishiga to‘g‘ri keladi — “gallyutsinatsiyalar” shundan kelib chiqadi. Buning uchun OpenCode AGENTS.md faylidan foydalanadi. Xuddi shu yondashuv Claude Code va boshqa istalgan agentga ham tegishli; faqat ko‘rsatmalar faylining nomi o‘zgaradi.

OpenCode’ni macOS va Linux’da qanday o‘rnatish mumkin?

Asosiy xulosalar

Terminalda bitta buyruq: curl -fsSL https://opencode.ai/install | bash. Hujjatlarda bu eng sodda usul deb ataladi. Muqobil variantlar: brew install anomalyco/tap/opencode, npm install -g opencode-ai va Arch Linux’da pacman yoki paru.

Tavsiya etilgan yo‘l — rasmiy o‘rnatuvchi:

  1. O‘rnatuvchini ishga tushiring

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

    Skript tizimingizni aniqlaydi va OpenCode’ni yuklab oladi. O‘rnatilgandan keyin buyruq topilmasa, terminalni yopib, qayta oching; yangi seansda yo‘l aniqlanadi.

  2. To‘g‘ri o‘rnatilganini tekshiring

    opencode --version
    

    Buyruq versiya raqamini qaytaradi, demak o‘rnatish muvaffaqiyatli bo‘lgan. “command not found” javobi birinchi bosqichga qaytaradi: yangi terminal seansini boshlang yoki PATH’ni qo‘lda tahrirlang.

Paketlarni o‘zingiz boshqarishni afzal ko‘rsangiz, quyidagi variantlar bor:

brew install anomalyco/tap/opencode
npm install -g opencode-ai

Homebrew buyrug‘i ataylab anomalyco/tap/ bilan boshlanadi: hujjatlarda o‘z tap’idan foydalanish tavsiya etiladi, chunki Homebrew jamoasi brew install opencode formulasi uchun yangilanishlarni kamroq chiqaradi. Xuddi shu opencode-ai paket nomi bun, pnpm va yarn’da ham ishlaydi (bun install -g opencode-ai, yarn global add opencode-ai). Arch Linux’da barqaror ombordan sudo pacman -S opencode yoki AUR’dan so‘nggi versiyani olish uchun paru -S opencode-bin buyrug‘idan foydalaning.

OpenCode’ni opencode upgrade bilan yangilang; avtomatik yangilash yoqilgan bo‘lsa, ishga tushganda o‘zi ham yangilanishlarni yuklab oladi. Yangilangandan keyin odatdagi opencode --version buyrug‘i bilan versiyani tekshiring. Olib tashlash funksiyasi ham o‘rnatilgan:

opencode uninstall

Buyruq aynan nimalar o‘chirilishini ko‘rsatadi va tasdiqlashni so‘raydi. Xohlasangiz, sozlamalar va seans ma’lumotlarini saqlab qolishingiz mumkin: --keep-config va --keep-data bayroqlaridan foydalaning.

OpenCode’ni Windows’da qanday o‘rnatish mumkin?

Asosiy xulosalar

Hujjatlarda unumdorlik va to‘liq moslik uchun WSL tavsiya etiladi: Windows Subsystem for Linux’ni o‘rnating, keyin OpenCode’ni uning ichida odatdagi Linux buyrug‘i bilan o‘rnating. WSL’siz Chocolatey (choco install opencode), Scoop (scoop install opencode), npm yoki ish stoli ilovasidan foydalanishingiz mumkin.

Ishlab chiquvchilarning o‘zi tavsiya qilgan birinchi variant — WSL. Uni administrator sifatida ishlayotgan PowerShell’da bitta buyruq bilan o‘rnating:

wsl --install

Kompyuterni qayta ishga tushirgandan keyin Start menyusidan Ubuntu’ni oching va uning ichida odatdagi buyruqni bajaring:

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

Windows disklaridagi fayllar WSL’da /mnt/ orqali mavjud: C: diski /mnt/c/ da, D: diski esa /mnt/d/ da. Demak, C:\Users\Name\project loyihasini quyidagicha ochish mumkin:

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

Ikkinchi variant — WSL’dan voz kechib, Windows paket menejerlaridan foydalanish. PowerShell’da:

choco install opencode
scoop install opencode

Uchinchi variant — ish stoli ilovasi va veb-versiya. Ilova odatiy dastur kabi o‘rnatiladi va terminal ishlatmasdan interfeysni oynada ko‘rsatadi. Veb-versiya opencode web buyrug‘i bilan ishga tushadi: u OpenCode’ni brauzerda ochadi, hujjatlarda esa fayllarga kirish muammolaridan qochish uchun uni WSL’dan ishga tushirish tavsiya qilinadi. Hujjatlarda kamroq ishlatiladigan variantlar — mise, Docker va GitHub relizlar sahifasidagi tayyor ikkilik fayl ham ko‘rsatilgan. Windows’da bun orqali o‘rnatish hali ishlab chiqilmoqda; bun asosiy paket menejeringiz bo‘lsa, npm variantidan foydalaning.

OpenCode’ga modelni qanday ulash mumkin?

Asosiy xulosalar

Terminal interfeysida /connect deb yozing va ro‘yxatdan provayderni tanlang: o‘z kalitlaringizsiz boshlash uchun OpenCode Zen, API kaliti bilan Anthropic yoki OpenAI, obuna orqali ChatGPT Plus yoki GitHub Copilot yoki mahalliy model uchun Ollama. Kalitlar auth.json faylida saqlanadi; /models orqali muayyan modelni tanlang.

OpenCode AI SDK va Models.dev orqali 75 dan ortiq provayderni, shuningdek mahalliy modellarni qo‘llab-quvvatlaydi. Ko‘pchiligini interfeys ichidagi /connect buyrug‘i orqali ulash mumkin; mahalliy modellar uchun esa sozlamalarda server manzilini ham ko‘rsatish kerak. Variantlar to‘lov usuli va kompyuterga qo‘yiladigan talablar bo‘yicha farqlanadi:

VariantBu nimaNarxi
OpenCode ZenOpenCode jamoasi tekshirgan model agregatoriHar bir so‘rov uchun to‘lov, balansni to‘ldiring
OpenCode GoJamoaning ochiq modellar uchun obuna rejasiGo oyiga $10 yoki Go Plus (yuqoriroq limitlar) oyiga $40
API kalitiAnthropic, OpenAI, Google, DeepSeek va boshqalarFoydalanish uchun provayderga to‘lov qilasiz
ObunaChatGPT Plus, GitHub Copilot, GitLab DuoOldindan to‘langan
Ollama / LM StudioUskunangizdagi mahalliy modelAPI to‘lovlari yo‘q, ammo yaxshi kompyuter kerak

Hujjatlarda yangi boshlovchilarga OpenCode Zen’dan boshlash tavsiya qilinadi. Jamoa aynan agent sifatida yaxshi ishlaydigan modellarni tanlab, provayderlar bilan uyg‘unliklarini o‘z vazifalarida sinab ko‘rgan.

Ulash jarayoni quyidagicha: /connect kiriting, OpenCode Zen’ni tanlang, tizimga kiring va opencode.ai/auth sahifasida to‘lov qo‘shing, kalit oling va uni kiriting. Shundan so‘ng /models tavsiya etilgan modellar ro‘yxatini ko‘rsatadi. 2026-yil 4-oktabr holatiga ko‘ra, ro‘yxatga, masalan, GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 va Kimi K2.5 kiradi. Hujjatlarda ro‘yxat to‘liq emasligi va yangi modellar har hafta chiqayotgani sabab tez eskirishi ochiq aytilgan.

Obunalar ham xuddi shu /connect buyrug‘i bilan ulanadi: ro‘yxatdan ChatGPT Plus yoki GitHub Copilot’ni tanlang va hisobingizga kiring — qo‘shimcha sozlash kerak emas.

Anthropic’ni tanlasangiz, /connect ikkita variantni taklif qiladi: API kalitini qo‘lda kiritish yoki Claude Pro/Max’ni tanlab, brauzer orqali autentifikatsiyadan o‘tish. Biroq Anthropic Claude Pro/Max obunasidan foydalanish uchun uchinchi tomon plaginlarini taqiqlaydi va OpenCode 1.3.0 versiyasidan boshlab bunday o‘rnatilgan plaginlar olib tashlangan. “Claude obunasi orqali OpenCode” haqidagi eski maqolalarga duch kelsangiz, ular olib tashlangan plaginlarni nazarda tutadi, rasmiy ruxsatni emas. ChatGPT Plus, GitHub Copilot, GitLab Duo (eksperimental deb belgilangan) va Atomic Chat obunalari qo‘shimcha sozlashsiz ishlaydi.

OpenCode /connect orqali kiritgan kalitlaringizni ~/.local/share/opencode/auth.json faylida saqlaydi. Har safar model tanlashni istamasangiz, loyiha ildizidagi opencode.json sozlama faylida standart modelni belgilang:

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

Format — provider/model; ikkala identifikator ham /models natijasida ko‘rsatiladi.

Ollama orqali mahalliy modelni qanday ulash mumkin?

Asosiy xulosalar

Ollama’ni ollama.com saytidan o‘rnating, ollama pull buyrug‘i bilan modelni yuklab oling — Ollama OpenCode uchun o‘zini avtomatik sozlay oladi. Qo‘lda sozlash uchun mahalliy server manzili http://localhost:11434/v1 bilan opencode.json fayliga provayder qo‘shing. Modelni /models orqali tanlang. Agar agent vositalarni chaqirmasa, Ollama’da num_ctx qiymatini 16k–32k gacha oshiring.

Bu variantda API to‘lovlari umuman bo‘lmaydi: model kompyuteringizda ishlaydi. Umuman bepul modellar orasidan tanlayotgan bo‘lsangiz, qaysilari agent sifatida yomon bo‘lmagan darajada ishlashi, qaysilari esa faqat qog‘ozda shunday ko‘rinishi haqida alohida sharhimiz bor. OpenCode uchun Ollama’ni rasmiy saytdan o‘rnating va modelni yuklab oling:

ollama pull qwen3-coder

Hujjatlardagi foydali jihat: Ollama OpenCode uchun o‘zini avtomatik sozlay oladi; buning alohida integratsiya qo‘llanmasi bor. Hammasini qo‘lda sozlamoqchi bo‘lsangiz, mahalliy Ollama serveringiz manzili bilan opencode.json fayliga provayder qo‘shing:

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

Shundan keyin interfeysdagi /models ro‘yxatida mahalliy model ko‘rinadi. Uni tanlab, ishni boshlang. Hujjatlardagi amaliy eslatma: agar agent vositalarni (fayllarni tahrirlash yoki buyruqlarni bajarish) chaqirishni to‘xtatsa, Ollama sozlamalaridagi num_ctx qiymatini oshiring — 16k–32k qiymatlardan boshlang. Mahalliy modellar aynan agent vazifalarida bulutli modellardan kuchsizroq, kichik kontekst esa vaziyatni og‘irlashtiradi. Mahalliy versiya yetarli bo‘lmasa, Qwen’ni bulutdan kalit bilan ulashingiz mumkin; uni qayerdan olish Qwen Code uchun API kalitini olish haqidagi qo‘llanmada yoritilgan.

OpenCode va undan foydalanish qancha turadi?

Asosiy xulosalar

OpenCode’ning o‘zi bepul: uning manba kodi MIT litsenziyasi ostida e’lon qilingan. Faqat model uchun to‘laysiz: API kaliti yoki Zen orqali haqiqiy foydalanish bo‘yicha, Go obunasi bilan, ChatGPT Plus yoki Copilot obunangiz orqali yoxud umuman to‘lamaysiz — Ollama orqali mahalliy modelga yuborilgan so‘rovlar bepul.

Bu yerda barcha xarajatlar modelga tegishli va to‘rtta holat bor. API kaliti yoki Zen bilan haqiqiy foydalanish uchun to‘laysiz, miqdor esa agent qancha ishlashiga bog‘liq. Go — OpenCode jamoasining ochiq modellar uchun obuna rejasi: Go oyiga $10, yuqoriroq limitli Go Plus esa oyiga $40 (2026-yil 4-oktabrda opencode.ai/go sahifasida tekshirilgan). Limit modelga bog‘liq: masalan, Go’da Kimi K3 uchun 5 soatda taxminan 110 ta so‘rov (oyiga 440 ta), yengilroq DeepSeek V4.1 Flash uchun esa 5 soatda taxminan 26 000 ta so‘rov mumkin. Limitdan tashqari muayyan modelga kirish uchun hujjatlarda alohida narx ko‘rsatilgan (Kimi K3 uchun oyiga $15, Go Plus uchun $60). Modellar va limitlarning to‘liq ro‘yxatini ulanish paytida obuna sahifasidan ko‘ring. ChatGPT Plus yoki Copilot’da so‘rovlar siz to‘lab yurgan obuna doirasiga kiradi; obunalarning o‘zida foydalanish intensivligi bo‘yicha limitlar borligini unutmang. Nihoyat, Ollama orqali mahalliy modelga so‘rovlar bepul, ammo uni tez ishlatish uchun yetarlicha kuchli kompyuter kerak.

Ilk ishga tushirishda nima qilish kerak?

Asosiy xulosalar

Loyiha papkangizga o‘ting, opencode’ni ishga tushiring va /init buyrug‘idan foydalaning — agent loyihani tekshiradi va uni tavsiflovchi AGENTS.md faylini yaratadi. Tahrirlarni boshlashdan oldin Plan rejimiga o‘tish uchun Tab’ni bosing: u yechim taklif qiladi va tahrirlarni tasdiqlashingiz uchun ko‘rsatadi. Xato harakatlarni /undo bilan bekor qiling.

Birinchi ishga tushirish — loyiha papkasi ichida:

cd path/to/project
opencode

Interfeys kiritish maydoni bilan ochiladi. Avval /init buyrug‘idan foydalaning: agent ombordagi muhim fayllarni tekshiradi, kerak bo‘lsa bir-ikkita savol beradi va AGENTS.md faylini yozadi — unda loyiha tuzilishi, yig‘ish va testlar uchun ishlatiladigan buyruqlar hamda qoidalar tasvirlanadi. Hujjatlarda bu faylni git’ga topshirish tavsiya qilinadi; shunda OpenCode undan doimiy loyiha ko‘rsatmasi sifatida foydalanadi. Vazifasi jihatidan AGENTS.md — OpenCode ekotizimida CLAUDE.md’ning bevosita muqobili.

Ikkinchidan, Plan rejimidan foydalaning. Tab tugmasi ikkita asosiy agent o‘rtasida almashadi: Build fayllar va buyruqlarga to‘liq kirish bilan ishlaydi, Plan esa tahlil va rejalashtirish uchun mo‘ljallangan — Plan rejimida fayl tahrirlash va bash buyruqlarini bajarish uchun odatda sizning tasdig‘ingiz kerak bo‘ladi. Yangi topshiriqlar uchun hujjatlarda rejadan boshlash tavsiya qilinadi: agent nima qilishni rejalashtirganini o‘qing, matnini moslang va shundan keyingina Tab bilan Build’ga qayting.

Hujjatlarda quyidagi maslahat berilgan:

U bilan jamoangizdagi kichik dasturchi bilan gaplashgandek gaplashish foydali.

— OpenCode rasmiy hujjatlari, https://opencode.ai/docs/

Topshiriq qanchalik aniq va kontekst qanchalik ko‘p bo‘lsa, qayta ishlashga shunchalik kam vaqt ketadi. So‘rovga fayllarni @ bilan qo‘shing — nomini yoza boshlang, interfeys ularni taxminiy qidiruv bilan topadi. Rasmlarni bevosita terminalga sudrab tashlashingiz mumkin, ! bilan boshlanadigan xabar esa qobiq buyrug‘i sifatida bajariladi; uning natijasi agent kontekstiga qo‘shiladi. Topshiriqda xato qilgan bo‘lsangiz yoki agent noto‘g‘ri ish qilgan bo‘lsa, /undo o‘zgarishlarni qaytaradi; uni ketma-ket bir necha marta ishga tushirishingiz mumkin. Fikringiz yana o‘zgardimi? /redo bekor qilingan o‘zgarishlarni tiklaydi. /share esa jamoangiz uchun suhbat havolasini yaratadi; bu buyruqsiz suhbat hech qayerga e’lon qilinmaydi.

OpenCode yana nimalar qila oladi?

Asosiy xulosalar

.opencode/commands papkasidagi markdown fayllar orqali maxsus buyruqlar, parallel vazifalar va kodni o‘qish uchun subagentlar, tashqi vositalar uchun MCP serverlari, brauzerdagi veb-versiya va masofadan ishlash uchun server rejimi.

Maxsus buyruqlar. Takrorlanadigan istalgan so‘rovni buyruqqa aylantirish mumkin: .opencode/commands/ ichiga markdown fayl qo‘ying, uning frontmatter qismida description, agent va model ni belgilang, so‘ng pastiga so‘rov shablonini yozing. Buyruqni / bilan chaqiring. Nashrdan oldingi loyiha tekshiruvlari, so‘nggi xatolarni ko‘rib chiqish, migratsiya yaratish — muntazam so‘raydigan istalgan vazifangiz.

Subagentlar. Build va Plan’dan tashqari yana uchtasi bor: General — ko‘p bosqichli vazifalar uchun (vazifalar ro‘yxatidan tashqari barcha vositalarga kirish huquqi bor), Explore — tahrirlashga ruxsatsiz kodni tez o‘qish uchun, Scout — tashqi kutubxonalarni o‘rganish uchun. Xabarda ularni @ bilan tilga olib chaqiring.

MCP serverlari. Tashqi vositalarni opencode.json sozlama faylining mcp bo‘limi orqali ulang — mahalliy va masofaviy serverlar qo‘llab-quvvatlanadi. Har bir MCP serveri o‘z vositalarini kontekstga qo‘shadi, GitHub kabi talabchan server esa kontekstni juda tez to‘ldirishi mumkin — faqat keraklilarini tanlab ulang. MCP tushunchasi bo‘yicha tayyor sozlamalarga ega qo‘llanmamiz bor; u Claude Code haqida yozilgan, ammo protokol umumiy.

Veb-versiya va server. opencode web interfeysni brauzerda ochadi. Boshqa qurilmadan kirish uchun opencode serve --hostname 0.0.0.0 --port 4096 buyrug‘idan foydalaning; tarmoqqa kirish imkoniyati bo‘lsa, OPENCODE_SERVER_PASSWORD o‘zgaruvchisi orqali parol o‘rnatishni unutmang. Parolsiz server himoyasiz bo‘ladi.

O‘rnatishda muammo chiqsa nima qilish kerak?

Asosiy xulosalar

Deyarli barcha muammolar uch narsaga borib taqaladi: opencode buyrug‘i topilmaydi (yangi terminal seansini boshlang yoki PATH’ni tahrirlang), model javob bermaydi (/connect va auth.json faylidagi kalitni tekshiring) yoki interfeys noto‘g‘ri ko‘rinadi (WezTerm kabi zamonaviy terminaldan foydalaning). Muammolarni bartaraf etishni ~/.local/share/opencode/log/ dagi jurnallardan boshlang.

O‘rnatilgandan keyin “opencode: command not found” xabari chiqsa. Terminal yangi yo‘lni hali bilmaydi. Avval uni yopib, qayta oching. Yordam bermasa, o‘rnatuvchi ikkilik faylni qayerga joylaganini topib, shu papkani terminalingizning PATH’iga qo‘shing.

Model javob bermayapti yoki avtorizatsiya xatosi yuz beryapti. Provayder ulanganini tekshiring: /connect buyrug‘ini kiriting va qayta autentifikatsiyadan o‘ting. Kalitlar ~/.local/share/opencode/auth.json faylida saqlanadi — o‘rnatishni boshqa kompyuterdan ko‘chirgan yoki papkalarni tozalagan bo‘lsangiz, fayl yo‘qolgan bo‘lishi mumkin. Hujjatlarda ProviderInitError va AI_APICallError xatolari alohida ko‘rib chiqilgan: birinchisi uchun provayderni qayta avtorizatsiya qiling; ikkinchisi uchun ~/.cache/opencode papkasini tozalab, OpenCode’ni qayta ishga tushiring.

Interfeys buzilgan: panellar tartibsiz joylashgan yoki belgilar o‘rniga o‘qib bo‘lmaydigan harflar ko‘rinadi. Avval terminalni tekshiring. Tavsiya qilingan variantlardan birini o‘rnating — WezTerm uchala tizimda ham ishlaydi — va OpenCode’ni shu terminaldan ishga tushiring.

Hech narsa yordam bermasa, jurnallarni tekshiring: macOS va Linux’da ular ~/.local/share/opencode/log/ papkasida; Windows’da Win+R’ni bosib, %USERPROFILE%\.local\share\opencode\log manzilini kiriting. Eng so‘nggi o‘nta fayl saqlanadi; batafsil jurnal yozuvlarini opencode --log-level DEBUG bayrog‘i bilan yoqing. Shu jurnallar bilan loyihaning Discord serveriga murojaat qilishingiz yoki GitHub’da xato haqida hisobot yuborishingiz mumkin.

Odamlar OpenCode haqida yana nimalarni so‘rashadi?

Asosiy xulosalar

Ko‘p uchraydigan savollarga qisqa javoblar: OpenCode vosita sifatida bepul; faqat model uchun to‘laysiz. Claude Pro/Max /connect orqali ulanadi, uchinchi tomon plaginlari esa taqiqlangan. Unga telefondan veb-versiya orqali kirish mumkin. OpenCode opencode upgrade buyrug‘i bilan yangilanadi.

Tez-tez so‘raladigan savollar

OpenCode bepulmi?

Ha, uning manba kodi MIT litsenziyasi ostida e’lon qilingan. Model uchun pul to‘lashingiz mumkin; barcha variantlar yuqoridagi xarajatlar bo‘limida ko‘rib chiqilgan.

Claude Pro/Max obunasini ulash mumkinmi?

Ha, Anthropic /connect ichida brauzer orqali autentifikatsiyadan o‘tadigan rasmiy Claude Pro/Max variantini taklif qiladi. Claude obunasini plaginlar orqali ishlatish haqidagi eski maqolalar eskirgan: Anthropic bunday plaginlarni taqiqlaydi va ular OpenCode’ning 1.3.0 versiyasidan boshlab olib tashlangan.

OpenCode’dan telefonda foydalanish mumkinmi?

Ishlaydigan variant — veb-versiya: kompyuter yoki serverda opencode serve buyrug‘ini ishga tushiring, keyin telefoningiz brauzeridan ulaning. Tarmoq orqali kirish uchun OPENCODE_SERVER_PASSWORD o‘zgaruvchisiga parol belgilash talab qilinadi.

OpenCode Claude Code’dan nimasi bilan yaxshiroq?

Bu sizning modellaringiz va obunalaringizga bog‘liq: Claude Code Anthropic modellari bilan integratsiyalashadi, OpenCode esa 75 dan ortiq provayder, ochiq kodli kod va mahalliy modellarni taklif qiladi. To‘liq taqqoslash uchun yuqoridagi jadvalga qarang.

OpenCode 2.0’ni darhol o‘rnatish kerakmi?

Shart emas. Hujjatlarda joriy birinchi versiya standart holatda tavsiya qilinadi — bu qo‘llanmada curl -fsSL https://opencode.ai/install | bash buyrug‘i bilan o‘rnatiladigan versiya. Ikkinchi versiya 2026-yil 4-oktabrdan beri mavjud, ammo unda plaginlar va server API bilan integratsiyalar boshqacha ishlaydi, ayrim kodlarni esa qayta yozish kerak bo‘ladi.

Ailoot’ni oching.

Batafsil

Ko‘p beriladigan savollar

OpenCode o‘rnatilishi nega ishlaydigan model bermaydi?

Vosita va modelga kirish alohida. /connect da provayder yoki mos obunani ulang yoxud mahalliy model sozlang. /models da modelni tanlab, bitta chegaralangan loyiha vazifasini tekshiring.

OpenCode 1.x’dan 2.0’ga o‘tishdan oldin nimani tekshiraman?

Plaginlar, server API integratsiyalari va terminal sozlamalari mosligini tekshiring. Qo‘llanmada ular migratsiya yo‘nalishlari sifatida ko‘rsatilgan. Dasturni almashtirishdan oldin versiyani tekshirib, konfiguratsiya va seanslarni saqlang.

Barcha maqolalar