OpenCode: орнату, модельдер және алғашқы іске қосу

OpenCode — терминалға арналған ашық бастапқы кодты AI бағдарламалау агенті: құралдың өзі тегін (MIT лицензиясы), ал оған Claude пен GPT-тен бастап Ollama арқылы іске қосылатын жергілікті модельге дейін кез келген модельді қосуға болады. Жоба репозиторийі GitHub-та екі жүз мыңнан астам жұлдыз жинап үлгерді. «Кез келген модельмен тегін Claude Code» деген тіркес тартымды естіледі, бірақ нақтылау қажет: құрал тегін, ал пайдалану шарттары таңдаған модельге байланысты.

Төменде ресми құжаттамаға сүйенген толық нұсқаулық берілген: құралдың не екені, оны macOS, Linux немесе Windows жүйесіне қалай орнату, модельді қалай қосу және алғаш іске қосқанда не істеу керек. Шығындарға арналған бөлек бөлім бар, өйткені мұндағы «тегін» деген құралға ғана қатысты: модельдер ақылы, ал түсінбеушілік көбіне осыдан туындайды.

Ailoot-пен жұмыс істеуге арналған практикалық ақпарат құжаттамада берілген.

OpenCode деген не, қарапайым тілмен айтқанда?#

Қысқаша айтқанда, OpenCode Claude Code сияқты жұмыс істейді: ол тапсырманы қарапайым тілмен қабылдап, жобаңызда орындайды. Екі айырмашылығы бар. Код толығымен ашық, сондықтан оны оқып, тексере аласыз. Құрал бір модель провайдеріне байланбаған: Anthropic пен OpenAI-дан бастап, жабдығыңызда іске қосылатын жергілікті модельге дейін 75-тен астам провайдермен жұмыс істейді.

Жобаны Anomaly командасы әзірлейді. Репозиторий 2025 жылғы 30 сәуірде құрылды, ал 2026 жылғы 4 қазанда оның 211 мыңнан астам жұлдызы және 28 мың форкы болды (GitHub API сұрауы арқылы тексерілген). Бағдарламалау тілі — TypeScript. Құжаттама үнемі жаңартылып отырады, сондықтан төмендегі нұсқаулар ағымдағы нұсқаға негізделген.

Атауларды шатастырмаңыз: ағымдағы тармақтың npm пакеті opencode-ai деп аталады, репозиторийі — anomalyco/opencode, ал терминал командасы жай ғана opencode. Ескі мақалаларда sst/opencode мекенжайы кездесуі мүмкін: ұйым атауын өзгертті, ал ескі сілтеме енді жаңа мекенжайға бағыттайды.

2026 жылғы 4 қазанда жаңартылды: команда құралдың келесі негізгі буыны OpenCode 2.0 нұсқасын шығарды. Төмендегі орнату және модель қосу нұсқаулары әлі де ағымдағы 1.x тармағына арналған (curl -fsSL https://opencode.ai/install | bash командасымен орнатылады; 2026 жылғы 30 қыркүйектегі ағымдағы нұсқасы — 1.18.34): ол белсенді қолдау көрсетілетін нұсқа және opencode.ai/docs мекенжайындағы ресми құжаттама орнататын нұсқа. Екінші нұсқада нақты не өзгергені және оған қашан ауысу керегі төмендегі бөлек бөлімде қарастырылған.

OpenCode Claude Code пен Codex-тен несімен ерекшеленеді?#

Егер Claude жазылымыңыз бар болса, негізгі құрал ретінде Claude Code-пен жұмыс істей берген жөн — бұл туралы бізде орнату жөніндегі толық нұсқаулық бар. OpenCode үш жағдайда орынды: ChatGPT Plus немесе GitHub Copilot жазылымы арқылы жұмыс істегіңіз келсе, API төлемінсіз жергілікті модельді іске қосқыңыз келсе немесе бірнеше модельге арналған бір интерфейс қажет болса. Codex туралы да шолуымыз бен орнату нұсқаулығымыз бар.

Егер әлі құрал таңдап жүрсеңіз, мына шолудан бастаңыз: 2026 жылы адамдар немен код жазады. Ал OpenCode орнатылып қойған болса және оны ACP арқылы Devin Desktop ішіндегі басқа агенттерге қосу керек болса, осы конфигурация жөніндегі нұсқаулығымызды қараңыз.

OpenCode 2.0 нұсқасында не өзгерді?#

Екінші нұсқа curl -fsSL https://opencode.ai/v2/install | bash командасымен орнатылады. Ресми көшу нұсқаулығына (opencode.ai/v2/docs/migrate-v1) сәйкес, екі нұсқа да бір opencode командасын қолданады және енді әдепкіде қатар орнатылмайды: v2 орнатқышы v1 бинарлық файлын алмастырады, ал v2 нұсқасын пакет менеджері арқылы орнатпас бұрын, құжаттама v1 нұсқасын алдымен жоюды тікелей талап етеді. Дегенмен конфигурация сол файлдардан оқылады — ~/.config/opencode/ және <project>/.opencode/ — сондықтан баптаулар, агенттер мен MCP серверлері қайта жазусыз көшіріледі. Үш нәрсені қайта жазу қажет: плагиндер (олардың API-і жаңарған), сервер API-імен интеграциялар (протокол өзгерген) және терминал баптаулары (енді бірнеше tui.json файлының орнына ортақ бір cli.json файлы қолданылады).

v2 нұсқасындағы ең елеулі екі жаңа мүмкіндік мынадай. Біріншіден, Console енгізілді — пайдалану есебі, бюджеттер және барлық топ мүшесіне ортақ саясаттары бар ақылы командалық қызмет. Екіншіден, команда Go жазылымының бағасын ақыры жариялады: Go айына $10, ал лимиттері жоғары Go Plus айына $40 тұрады (opencode.ai/go беті, 2026 жылғы 4 қазанда тексерілген). Бұған дейін құжаттамада нақты соманың орнына жай ғана «арзан жазылым» деп жазылған.

Егер жаңадан бастап, агентті орнатқыңыз келсе, төмендегі нұсқауларды орындаңыз; олар құжаттаманың өзі ұсынатын ағымдағы бірінші нұсқаны қамтиды. Жаңа плагин мүмкіндіктері немесе командалық Console қажет болса, v2 нұсқасын қарастырыңыз, бірақ ескі плагиндердің кейбірін жаңа API үшін қайта жазуға дайын болыңыз. Терминал қажет етпейтін ашық бастапқы кодты жұмыс үстелі қолданбасы көбірек қызықтырса, интерфейсі ұқсас басқа агент ZCode туралы шолуымызды оқыңыз.

Орнатпас бұрын не қажет?#

Терминал туралы толығырақ айтайық, өйткені орнату ойдағыдай өтпеуі мүмкін жалғыз орын — осы. OpenCode терминалда панельдері мен ерекшелеуі бар толық интерфейсті көрсетеді, сондықтан құжаттама заманауи эмуляторды талап етеді. Іске қосқаннан кейін интерфейс дұрыс көрінбесе, алдымен аталған төрт нұсқаның бірін орнатыңыз: WezTerm (барлық жүйеде жұмыс істейді), Alacritty, Ghostty немесе Kitty. Windows жүйесінде негізгі жол — WSL арқылы орнату; оған төменде жеке бөлім арналған.

Екінші қажет нәрсе — модель. OpenCode сіз қосқан модель арқылы жұмыс істейді: өздігінен сұрауларды өңдемейді. Төрт нұсқа бар: жазылым (ChatGPT Plus, GitHub Copilot, GitLab Duo), кез келген провайдердің API кілті, команда әзірлеген OpenCode Zen агрегаторы немесе Ollama арқылы жергілікті модель. Төртеуі де модель қосу бөлімінде қарастырылған.

Жоба сипаттамасы болмаса, агент құрастыру командаларын, файл құрылымын және қолданылатын ережелерді өзі болжауға мәжбүр болады — «галлюцинациялар» осыдан туындайды. OpenCode бұл үшін AGENTS.md файлын пайдаланады. Дәл осы тәсіл Claude Code және кез келген басқа агентке де қатысты; тек нұсқаулар файлының атауы өзгереді.

OpenCode-ты macOS пен Linux жүйелеріне қалай орнатуға болады?#

Ұсынылатын жол — ресми орнатқышты пайдалану:

1. Орнатқышты іске қосыңыз

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

   Скрипт жүйеңізді анықтап, OpenCode жүктеп алады. Орнатудан кейін команда табылмаса, терминалды жауып, қайта ашыңыз; жаңа сессияда жол анықталады.

2. Дұрыс орнатылғанын тексеріңіз

   opencode --version
   

   Команда нұсқа нөмірін қайтарса, орнату сәтті аяқталған. «command not found» жауабы бірінші қадамға қайтарады: жаңа терминал сессиясын бастаңыз немесе PATH мәнін қолмен өңдеңіз.

Пакеттерді өзіңіз басқарғыңыз келсе, мына нұсқалар бар:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Homebrew командасы әдейі anomalyco/tap/ деп басталады: құжаттама өз tap-ын ұсынады, өйткені Homebrew командасы brew install opencode формуласын сирегірек жаңартады. Дәл осы opencode-ai пакет атауы bun, pnpm және yarn жүйелерінде де жұмыс істейді (bun install -g opencode-ai, yarn global add opencode-ai). Arch Linux жүйесінде тұрақты репозиторийден алу үшін sudo pacman -S opencode, ал AUR-дан соңғы нұсқасын алу үшін paru -S opencode-bin пайдаланыңыз.

OpenCode-ты opencode upgrade командасымен жаңартыңыз; автоматты жаңарту қосулы болса, бағдарлама іске қосылғанда жаңартуларды өзі де жүктейді. Жаңартудан кейін таныс opencode --version командасымен нұсқаны тексеріңіз. Жою мүмкіндігі де кіріктірілген:

opencode uninstall

Команда нақты не жойылатынын көрсетіп, растауды сұрайды. Қаласаңыз, конфигурация мен сессия деректерін сақтай аласыз: --keep-config және --keep-data жалаушаларын пайдаланыңыз.

OpenCode-ты Windows жүйесіне қалай орнатуға болады?#

Әзірлеушілердің өздері ұсынатын бірінші нұсқа — WSL. Оны әкімші ретінде іске қосылған PowerShell терезесінде бір командамен орнатыңыз:

wsl --install

Компьютер қайта іске қосылғаннан кейін, «Бастау» мәзірінен Ubuntu ашып, оның ішінде таныс команданы іске қосыңыз:

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

Windows дискілеріндегі файлдар WSL жүйесінде /mnt/ арқылы қолжетімді: C: дискісі — /mnt/c/, ал D: дискісі — /mnt/d/. Сондықтан C:\Users\Name\project жолындағы жобаны былай ашуға болады:

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

Екінші нұсқа — WSL жүйесін өткізіп, Windows пакет менеджерлерін пайдалану. PowerShell ішінде:

choco install opencode

scoop install opencode

Үшінші нұсқа — жұмыс үстелі қолданбасы мен веб-нұсқа. Қолданба кәдімгі бағдарлама сияқты орнатылып, терминалсыз-ақ интерфейсті терезеде көрсетеді. Веб-нұсқа opencode web командасымен іске қосылады: OpenCode браузерде ашылады, ал құжаттама файлдарға қол жеткізу мәселелерін болдырмау үшін оны WSL ішінен іске қосуды да ұсынады. Құжаттамада сирек қолданылатын басқа нұсқалар да бар: mise, Docker және GitHub releases бетіндегі дайын бинарлық файл. Windows жүйесінде bun арқылы орнату әлі әзірленіп жатыр; bun негізгі пакет менеджеріңіз болса, npm нұсқасын қолданыңыз.

OpenCode-қа модельді қалай қосуға болады?#

OpenCode AI SDK және Models.dev арқылы 75-тен астам провайдерді, сондай-ақ жергілікті модельдерді қолдайды. Олардың көбін интерфейстің ішінде /connect командасымен қосады; жергілікті модельдер үшін конфигурацияда сервер мекенжайын да көрсету қажет. Нұсқалар төлем тәсілі мен компьютерге қойылатын талаптарымен ерекшеленеді:

Құжаттама жаңадан бастаушыларға OpenCode Zen-нен бастауды ұсынады. Команда агент ретінде жақсы жұмыс істейтін модельдерді таңдап, оларды провайдерлермен біріктіріп, өз тапсырмаларында сынаған.

Қосу тәртібі мынадай: /connect деп енгізіп, OpenCode Zen таңдаңыз, opencode.ai/auth мекенжайында жүйеге кіріп, төлем қосыңыз, кілт алып, оны енгізіңіз. Содан кейін /models ұсынылған модельдер тізімін көрсетеді. 2026 жылғы 4 қазандағы жағдай бойынша тізімде, мысалы, GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 және Kimi K2.5 бар. Құжаттама тізімнің толық емес екенін және апта сайын жаңа модельдер шығатындықтан тез ескіретінін ашық ескертеді.

Жазылымдар да сол /connect командасымен қосылады: тізімнен ChatGPT Plus немесе GitHub Copilot таңдап, тіркелгіңізге кіріңіз — қосымша баптау қажет емес.

Anthropic таңдасаңыз, /connect екі нұсқаны ұсынады: API кілтін қолмен енгізу немесе Claude Pro/Max таңдап, браузер арқылы растау. Алайда Anthropic Claude Pro/Max жазылымын пайдалану үшін бөгде плагиндерге тыйым салады, ал мұндай кіріктірілген плагиндер OpenCode-тың 1.3.0 нұсқасынан бастап алынып тасталды. «Claude жазылымы арқылы OpenCode» туралы ескі мақала кездессе, онда ресми рұқсат емес, қазір алынып тасталған плагиндер туралы айтылған. ChatGPT Plus, GitHub Copilot, GitLab Duo (эксперименттік деп белгіленген) және Atomic Chat жазылымдары қосымша баптаусыз жұмыс істейді.

/connect арқылы енгізген кілттер OpenCode-та ~/.local/share/opencode/auth.json файлында сақталады. Әр жолы модель таңдауды қаламасаңыз, әдепкі модельді жоба түбіріндегі opencode.json конфигурация файлына орнатыңыз:

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

Пішімі — provider/model; екі идентификатор да /models нәтижесінде көрсетіледі.

Ollama арқылы жергілікті модельді қалай қосуға болады?#

Бұл нұсқада API төлемі мүлде болмайды: модель компьютеріңізде жұмыс істейді. Жалпы тегін модельдердің бірін таңдап жүрсеңіз, қайсысы агент ретінде тәуір жұмыс істейтіні, ал қайсысы тек қағаз жүзінде солай екені туралы жеке шолуымызды оқыңыз. OpenCode үшін Ollama-ны ресми сайттан орнатып, модельді жүктеңіз:

ollama pull qwen3-coder

Құжаттамадағы пайдалы бір жайт: Ollama OpenCode-ты автоматты түрде баптай алады; бұл туралы жеке интеграция нұсқаулығы бар. Бәрін қолмен баптағыңыз келсе, жергілікті Ollama серверінің мекенжайы көрсетілген провайдерді opencode.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"
        }
      }
    }
  }
}

Содан кейін интерфейстегі /models тізімінде жергілікті модель пайда болады. Оны таңдап, жұмысқа кірісіңіз. Құжаттамадағы бір практикалық ескерту: егер агент құралдарды (файлдарды өңдеу немесе командаларды іске қосу) пайдалануды тоқтатса, Ollama баптауларындағы num_ctx мәнін арттырыңыз — 16k–32k мәндерінен бастаңыз. Жергілікті модельдер агенттік жұмыста бұлттық модельдерден әлсіздеу, ал шағын контекст жағдайды қиындата түседі. Жергілікті нұсқа жеткіліксіз болса, кілт арқылы Qwen бұлттық моделін қосуға болады; оны қайдан алуға болатыны Qwen Code үшін API кілтін алу жөніндегі нұсқаулықта түсіндірілген.

OpenCode пен оны пайдалану қанша тұрады?#

Мұндағы барлық шығын модельге қатысты және төрт сценарий бар. API кілті немесе Zen арқылы нақты пайдаланғаныңыз үшін төлейсіз, ал сома агенттің қанша жұмыс істейтініне байланысты. Go — OpenCode командасы ұсынатын ашық модельдерге арналған жазылым жоспары: Go айына $10, ал лимиті жоғары Go Plus айына $40 тұрады (opencode.ai/go бетінде 2026 жылғы 4 қазанда тексерілген). Лимит модельге байланысты: мысалы, Go жазылымында Kimi K3 үшін 5 сағатта шамамен 110 сұрауға (айына 440), ал жеңілірек DeepSeek V4.1 Flash үшін 5 сағатта шамамен 26,000 сұрауға рұқсат. Лимиттен тыс нақты модельді пайдалану үшін құжаттамада бөлек баға көрсетілген (Kimi K3 үшін айына $15, Go Plus үшін $60). Модельдер мен лимиттердің толық тізімін қосқан кезде жазылым бетінен қараңыз. ChatGPT Plus немесе Copilot арқылы сұраулар бұрыннан төлеп жүрген жазылымыңызбен қамтылады; жазылымдардың өзінде пайдалану қарқындылығына шектеулер барын ескеріңіз. Соңында, Ollama арқылы жергілікті модельге сұрау жіберу тегін, бірақ оны жылдам іске қосуға жететін қуатты компьютер қажет.

Алғаш іске қосқанда не істеу керек?#

Алғашқы іске қосу жоба қалтасының ішінде орындалады:

cd path/to/project
opencode

Енгізу өрісі бар интерфейс ашылады. Алдымен /init пәрменін пайдаланыңыз: агент репозиторийдегі маңызды файлдарды қарап, қажет болса бірнеше сұрақ қойып, AGENTS.md файлын жазады. Онда жоба құрылымы, құрастыру мен тестілеуге арналған командалар және қолданылатын ережелер сипатталады. Құжаттама бұл файлды git репозиторийіне коммиттеуді ұсынады; OpenCode оны тұрақты жоба нұсқауы ретінде пайдаланады. Мақсаты жағынан AGENTS.md — OpenCode экожүйесіндегі CLAUDE.md файлының тікелей баламасы.

Екіншіден, Plan режимін қолданыңыз. Tab пернесі екі негізгі агент арасында ауыстырады: Build файлдар мен командаларға толық қолжетімділікпен жұмыс істейді, ал Plan талдау мен жоспарлауға арналған — әдепкіде Plan режиміндегі файл өзгерістері мен bash командалары мақұлдауыңызды талап етеді. Жаңа тапсырманы жоспардан бастауды құжаттама ұсынады: агент не істегелі тұрғанын оқып, тұжырымын түзетіңіз де, содан кейін ғана Tab арқылы Build режиміне қайтыңыз.

Құжаттамада мынадай кеңес берілген:

Тапсырма неғұрлым нақты, ал беретін контекстіңіз неғұрлым мол болса, қайта өңдеу соғұрлым аз қажет болады. Сұрауға файлдарды @ арқылы қосыңыз — атауын тере бастағанда интерфейс оларды жуық сәйкестік бойынша іздейді. Суреттерді терминалға тікелей сүйреп апаруға болады, ал ! таңбасынан басталатын хабарлама shell командасы ретінде іске қосылып, оның нәтижесі агент контекстіне қосылады. Тапсырмада қателессеңіз немесе агент дұрыс істемесе, /undo өзгерістерді қайтарады; пәрменді қатарынан бірнеше рет орындауға болады. Ойыңыз тағы өзгерді ме? /redo қайтарылған өзгерістерді қалпына келтіреді. Ал /share командасы командаңызға арналған сөйлесу сілтемесін жасайды; бұл пәрменсіз сөйлесу еш жерде жарияланбайды.

OpenCode тағы не істей алады?#

Реттелетін пәрмендер. Қайталанатын кез келген сұрауды пәрменге айналдыруға болады: .opencode/commands/ қалтасына markdown файл салып, оның frontmatter бөлімінде description, agent және model мәндерін көрсетіп, төменіне сұрау үлгісін жазыңыз. Содан кейін пәрменді / арқылы шақырыңыз. Жарияламас бұрын жобаны тексеру, соңғы қателерді шолу, көшіруді жасау — тұрақты сұрайтын кез келген тапсырмаға жарайды.

Қосалқы агенттер. Build пен Plan-нан бөлек тағы үшеуі бар: General көп қадамды тапсырмаларға арналған (тапсырмалар тізімінен басқа барлық құралға қол жеткізеді), Explore рұқсатсыз кодты жылдам оқуға арналған, ал Scout сыртқы кітапханаларды зерттейді. Оларды хабарламада @ арқылы атап шақырыңыз.

MCP серверлері. Сыртқы құралдарды opencode.json конфигурациясының mcp бөлімі арқылы қосыңыз — жергілікті және қашықтағы серверлерге қолдау бар. Әр MCP сервері контекстке өз құралдарын қосады, ал GitHub сияқты ресурсты көп қажет ететін сервер контексті тез толтыруы мүмкін; сондықтан тек керегін ғана таңдаңыз. MCP тұжырымдамасы туралы бізде дайын конфигурациялары бар нұсқаулық бар; ол Claude Code жөнінде жазылғанымен, протокол ортақ.

Веб-нұсқа мен сервер. opencode web интерфейсті браузерде ашады. Басқа компьютерден қол жеткізу үшін opencode serve --hostname 0.0.0.0 --port 4096 командасын пайдаланыңыз; желі арқылы қолжетімділік болғанда OPENCODE_SERVER_PASSWORD айнымалысымен міндетті түрде құпиясөз орнатыңыз. Құпиясөзсіз сервер қорғалмаған.

Орнату кезінде бірдеңе дұрыс болмаса не істеу керек?#

Орнатудан кейін “opencode: command not found” деген хабар шығады. Терминал жаңа жолды әлі білмейді. Алдымен терминалды жауып, қайта ашыңыз. Көмектеспесе, орнатқыш бинарлық файлды қайда орналастырғанын тауып, сол қалтаны терминалдың PATH айнымалысына қосыңыз.

Модель жауап бермейді немесе авторизация қатесін көрсетеді. Провайдердің қосылғанын тексеріңіз: /connect енгізіп, қайта авторизациядан өтіңіз. Кілттер ~/.local/share/opencode/auth.json файлында сақталады; орнатуды басқа компьютерден көшірген немесе қалталарды тазалаған болсаңыз, файл жоқ болуы мүмкін. Құжаттамада ProviderInitError және AI_APICallError қателері бөлек қарастырылған: бірінші жағдайда провайдерге қайта авторизация жасаңыз, екіншісінде ~/.cache/opencode қалтасын тазалап, бағдарламаны қайта іске қосыңыз.

Интерфейс бұзылған: панельдер ретсіз орналасады немесе таңбалардың орнына оқылмайтын таңбалар шығады. Алдымен терминалды тексеріңіз. Ұсынылған нұсқалардың бірін орнатыңыз — WezTerm үш жүйенің бәрінде жұмыс істейді — сосын OpenCode-ты соның ішінен іске қосыңыз.

Ештеңе көмектеспесе, журналдарды тексеріңіз: macOS пен Linux жүйелерінде олар ~/.local/share/opencode/log/ ішінде; Windows жүйесінде Win+R пернелерін басып, %USERPROFILE%\.local\share\opencode\log деп енгізіңіз. Ең соңғы он файл сақталады; толық журналдауды opencode --log-level DEBUG жалаушасымен қосыңыз. Сол журналдармен жобаның GitHub репозиторийінде қате туралы есеп бере аласыз.

OpenCode туралы тағы не сұрайды?#

Ailoot сайтын ашыңыз.