public/opencode

OpenCode и модели Arka AI

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/

1. Запустите установщик своей ОС (bash или .ps1).
2. Полностью закройте приложение, не только окно. На Windows проверьте значок в трее. На macOS — Quit из меню, не красный крестик, если процесс остаётся в доке.
3. Откройте 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 (включая трей) и открыть снова.

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

1. Агент вызывает встроенный bash или PowerShell.
2. OpenCode спросит разрешение — нажмите Allow.
3. Скрипт пишет плагин, skill и ключ. --key / -Key обязателен: интерактивный ввод ключа в пайпе зависнет.
4. Полностью перезапустите 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.

Дальше:

1. Новый терминал (POSIX) или полный выход из Desktop.
2. Снова открыть OpenCode.
3. /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.