Arka AI — OpenAI-совместимый API (https://api.arka-ai.ru/v1). В каталоге models.dev его нет, поэтому в свежем OpenCode провайдера Arka-AI и списка моделей нет, пока не поставить плагин.

Одна команда ставит плагин, skill и (по желанию) ключ. Каталог чат-моделей подтягивается сам (~116 из ~216; без TTS, картинок, видео и эмбеддингов). Снимок каталога обновляется каждый день в 05:00 по Москве.

Нужен API-ключ Arka AI. Секрет ключа показывается один раз при создании.

Плагин один и тот же для терминала (CLI) и OpenCode Desktop (окно + тот же sidecar). Меняется только способ запуска установщика и то, как в процесс попадает ключ.

macOS, Linux, Git Bash, WSL

curl -fsSL https://git.arka-ai.ru/arka/public/raw/branch/main/opencode/install-arka-provider.sh | bash

Скрипт спросит ARKA_API_KEY (можно оставить пустым и задать позже).

Ключ и модель по умолчанию сразу:

curl -fsSL https://git.arka-ai.ru/arka/public/raw/branch/main/opencode/install-arka-provider.sh \
  | bash -s -- --key "$ARKA_API_KEY" --set-default DeepSeek-V4-Pro

WSL и Git Bash — это linux-окружение со своим домашним каталогом. Native Windows Desktop его не видит: для приложения с ярлыка Windows нужен PowerShell-установщик ниже.

Windows (CLI и Desktop)

Официальный каталог конфига OpenCode на Windows — %USERPROFILE%\.config\opencode, то есть C:\Users\<имя>\.config\opencode. Туда же смотрит OpenCode Desktop. Не кладите плагин только в %APPDATA%\opencode — Desktop его оттуда не читает, если этого каталога ещё нет.

PowerShell:

irm https://git.arka-ai.ru/arka/public/raw/branch/main/opencode/install-arka-provider.ps1 | iex

С ключом и моделью по умолчанию:

iwr -useb https://git.arka-ai.ru/arka/public/raw/branch/main/opencode/install-arka-provider.ps1 `
  -OutFile $env:TEMP\install-arka.ps1
powershell -ExecutionPolicy Bypass -File $env:TEMP\install-arka.ps1 `
  -Key $env:ARKA_API_KEY -SetDefault DeepSeek-V4-Pro

cmd.exe:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://git.arka-ai.ru/arka/public/raw/branch/main/opencode/install-arka-provider.ps1 | iex"

Скрипт пишет:

%USERPROFILE%\.config\opencode\plugins\arka-ai.ts
%USERPROFILE%\.config\opencode\skills\arka-provider\SKILL.md
%USERPROFILE%\.config\opencode\.arka-api-key — Desktop читает ключ отсюда, login-shell не нужен
пользовательскую переменную среды ARKA_API_KEY (GUI подхватит после полного перезапуска)
копию в %APPDATA%\opencode, только если этот каталог уже есть

Если PowerShell ругается на политику выполнения — используйте -ExecutionPolicy Bypass, как в команде с -File.

OpenCode Desktop (Windows, macOS, Linux)

Desktop — это окно + тот же CLI. Отдельного «магазина» и отдельного плагина для GUI нет.

ОС	Куда ставится плагин, skill и ключ
Windows	`%USERPROFILE%\.config\opencode\`
macOS	`~/.config/opencode/`
Linux	`~/.config/opencode/`

Запустите установщик своей ОС (bash или .ps1).
Полностью закройте приложение, не только окно. На Windows проверьте значок в трее. На macOS — Quit из меню, не красный крестик, если процесс остаётся в доке.
Откройте Desktop снова. /models — должен быть провайдер Arka-AI.

Desktop не читает ~/.bashrc / ~/.zshrc. Поэтому установщик кладёт ключ в файл .arka-api-key и (на Windows) в пользовательские переменные среды. Если модели видны в /models, а запросы отвечают 401 — ключ не попал в процесс: проверьте файл ключа и что приложение действительно перезапущено.

macOS Desktop ставится тем же bash-скриптом, что и CLI. После установки: полностью Quit и снова открыть приложение.

Из уже открытого OpenCode (CLI или Desktop)

Магазина плагинов нет. Можно не выходить из чата: попросите текущую модель (любую, не Arka) выполнить установщик.

macOS / Linux — вставьте в чат (подставьте свой ключ):

Поставь провайдер Arka AI для OpenCode. Не спрашивай ключ интерактивно.
Выполни одну команду и покажи вывод:

curl -fsSL https://git.arka-ai.ru/arka/public/raw/branch/main/opencode/install-arka-provider.sh | bash -s -- --key 'ARKA_API_KEY_HERE' --set-default DeepSeek-V4-Pro

После успеха напиши, что нужно полностью перезапустить OpenCode (конфиг не подхватывается на лету).

Windows — вставьте в чат:

Поставь провайдер Arka AI для OpenCode. Не спрашивай ключ интерактивно.
Выполни в PowerShell одну команду и покажи вывод:

powershell -ExecutionPolicy Bypass -Command "iwr -useb https://git.arka-ai.ru/arka/public/raw/branch/main/opencode/install-arka-provider.ps1 -OutFile $env:TEMP\install-arka.ps1; powershell -ExecutionPolicy Bypass -File $env:TEMP\install-arka.ps1 -Key 'ARKA_API_KEY_HERE' -SetDefault DeepSeek-V4-Pro"

После успеха напиши, что нужно полностью закрыть OpenCode Desktop и CLI (включая трей) и открыть снова.

Что происходит:

Агент вызывает встроенный bash или PowerShell.
OpenCode спросит разрешение — нажмите Allow.
Скрипт пишет плагин, skill и ключ. --key / -Key обязателен: интерактивный ввод ключа в пайпе зависнет.
Полностью перезапустите CLI или Desktop — плагин грузится только на старте. Затем /models → Arka-AI.

Пока сессия не перезапущена, разговор идёт на старой модели. Это нормально: установщик не требует Arka.

Что ставится

Куда	Что
`~/.config/opencode/plugins/arka-ai.ts` (Windows: `%USERPROFILE%\.config\opencode\plugins\arka-ai.ts`)	Плагин провайдера Arka-AI
`…/skills/arka-provider/SKILL.md`	Skill: как обновить каталог и сменить модель
`…/.arka-api-key`	Ключ для CLI и Desktop (GUI без login-shell)
`~/.bashrc` / `.zshrc` / `.profile`	`export ARKA_API_KEY=…` (только POSIX-установщик)
переменная среды пользователя Windows	`ARKA_API_KEY` (только `.ps1`)
`…/opencode.json`	Только при `--set-default` / `-SetDefault`: `"model": "Arka-AI/<id>"`. Существующий конфиг не затирается

Установщик идемпотентный: повторный запуск перезаписывает плагин и skill каноническими копиями. POSIX-скрипт после скачивания офлайн. python3 нужен только с --set-default. Отдельный bun не нужен — у OpenCode свой runtime.

Дальше:

Новый терминал (POSIX) или полный выход из Desktop.
Снова открыть OpenCode.
/models — провайдер Arka-AI и чат-модели.

Модель по умолчанию

Идентификаторы — как в каталоге, с префиксом провайдера:

{
  "model": "Arka-AI/DeepSeek-V4-Pro"
}

Примеры: Arka-AI/DeepSeek-V4-Pro, Arka-AI/qwen3.8-max, Arka-AI/kimi-k3, Arka-AI/MiniMax-M3, Arka-AI/GLM-5.3, Arka-AI/deepseek-v4-flash-0731.

Их всегда оставляем в списке, даже если фильтр чат-моделей их бы отсёк.

Обновить каталог

macOS / Linux:

rm -f ~/.cache/opencode/arka-ai-models.json

Windows (Win+R):

%USERPROFILE%\.cache\opencode\arka-ai-models.json

Удалите файл и полностью перезапустите OpenCode. Плагин сначала берёт публичный снимок https://git.arka-ai.ru/arka/public/raw/branch/main/opencode/catalog.json (без ключа), при ошибке — живой https://api.arka-ai.ru/v1/models. Локальный кэш живёт 24 часа. Конфиг на лету не перечитывается.

Список моделей (ключ не нужен):

curl -sS https://git.arka-ai.ru/arka/public/raw/branch/main/opencode/catalog.json | python3 -m json.tool

Вызовы моделей идут на https://api.arka-ai.ru/v1 с ключом из ARKA_API_KEY или из .arka-api-key.

Если что-то не так

Симптом	Что проверить
После `/models` нет Arka-AI	Есть ли `plugins/arka-ai.ts` в каталоге конфига выше; полностью ли перезапущен CLI/Desktop
Модели есть, запросы 401	Файл `.arka-api-key`; на Windows — User env и трей; Desktop не читает bashrc
Каталог не меняется	Удалить кэш `arka-ai-models.json` и рестарт
Ошибка импорта плагина	Снова запустить установщик
`curl` / `irm` отдаёт HTML	Нужен путь `/raw/branch/main/…`, не страница репозитория
Поставили в WSL, Desktop пустой	Native Windows Desktop смотрит в `%USERPROFILE%\.config\opencode`, не в home WSL — ставьте `.ps1`
Плагин в `%APPDATA%\opencode`, эффекта нет	Нужен `%USERPROFILE%\.config\opencode`

Файлы в этой папке

Файл	Назначение
`install-arka-provider.sh`	Установщик для macOS, Linux, WSL, Git Bash
`install-arka-provider.ps1`	Установщик для Windows (CLI и Desktop)
`plugins/arka-ai.ts`	Исходник плагина (встроен в оба установщика)
`skills/arka-provider/SKILL.md`	Исходник skill (встроен в оба установщика)
`catalog.json`	Каталог чат-моделей, обновляется ежедневно в 05:00 по Москве
`README.md`	Эта страница — можно копировать в раздел «агентные помощники» на arka-ai.ru

Каталог opencode/ лежит в публичном репозитории arka/public.

README.md Unescape Escape

OpenCode и модели Arka AI